mysqli_result::fetch_field_direct

    mysqli_fetch_field_direct

    (PHP 5, PHP 7, PHP 8)

    mysqli_result::fetch_field_direct -- mysqli_fetch_field_direct — 単一のフィールドのメタデータを取得する

    説明

    オブジェクト指向型

    publicmysqli_result::fetch_field_direct(int$index): object|false

    手続き型

    mysqli_fetch_field_direct(mysqli_result$result, int$index): object|false

    指定した結果セットから、フィールド定義情報を含むオブジェクトを返します。

    パラメータ

    result

    手続き型のみ: mysqli_query()、mysqli_store_result()、mysqli_use_result()、mysqli_stmt_get_result() が返す mysqli_result オブジェクト。

    index

    フィールド番号。この値は 0 から フィールド数 - 1 までの範囲でなければなりません。

    戻り値

    フィールド定義情報を含むオブジェクトを返します。もし、指定した index のフィールドの情報が取得できない場合は false を返します。

    オブジェクトの属性
    属性説明
    nameカラムの名前。
    orgnameもしエイリアスが指定されている場合の、本来の名前。
    tableフィールドが属するテーブルの名前。
    orgtableもしエイリアスが指定されている場合の、本来のテーブル名。
    defフィールドのデフォルト値。文字列形式。
    max_length結果セットにおけるフィールドの最大幅。PHP 8.1 以降では、この値は常に 0 です。
    lengthテーブルの定義で指定されているフィールド幅。
    charsetnrフィールドの文字セット番号。
    flagsフィールドのビットフラグを整数型で表す。
    typeフィールドのデータ型。
    decimalsフィールドの桁数（数値型のフィールド）。

    例

    例1 オブジェクト指向型

    <?php
    $mysqli     = new mysqli("localhost", "my_user", "my_password", "world");


    if (mysqli_connect_errno()) {
    printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
    }

    $query = "SELECT Name, SurfaceArea from Country ORDER BY Name LIMIT 5";

    if (    $result = $mysqli->query($query)) {


    $finfo = $result->fetch_field_direct(1);

    printf("Name: %s\n", $finfo->name);
    printf("Table: %s\n", $finfo->table);
    printf("max. Len: %d\n", $finfo->max_length);
    printf("Flags: %d\n", $finfo->flags);
    printf("Type: %d\n", $finfo->type);

    $result->close();
    }


    $mysqli->close();
    ?>

    例2 手続き型

    <?php
    $link     = mysqli_connect("localhost", "my_user", "my_password", "world");


    if (mysqli_connect_errno()) {
    printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
    }

    $query = "SELECT Name, SurfaceArea from Country ORDER BY Name LIMIT 5";

    if (    $result = mysqli_query($link, $query)) {


    $finfo = mysqli_fetch_field_direct($result, 1);

    printf("Name: %s\n", $finfo->name);
    printf("Table: %s\n", $finfo->table);
    printf("max. Len: %d\n", $finfo->max_length);
    printf("Flags: %d\n", $finfo->flags);
    printf("Type: %d\n", $finfo->type);

    mysqli_free_result($result);
    }


    mysqli_close($link);
    ?>

    上の例の出力は以下となります。

    Name: SurfaceArea Table: Country max. Len: 10 Flags: 32769 Type: 4

    参考

    To Top