English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

PHP基本教程

PHP上級教程

PHP & MySQL

PHPリファレンスマニュアル

PHP mysqli_fetch_field_direct()関数の用法および例

   PHP MySQLi リファレンスマニュアル

mysqli_fetch_field_direct()関数は、単一のフィールドのメタデータを取得します

定義と用法

PHPの結果オブジェクト(mysqli_resultクラス)は、SELECTやDESCRIBEやEXPLAINクエリによって返されるMySQLの結果を表します。
mysqli_fetch_field_direct()関数は、結果オブジェクトとフィールド番号を整数として受け取り、指定された列のオブジェクトを返します/フィールドの定義情報。

構文

mysqli_fetch_field_direct($result, $field);

パラメータ

序号パラメータ及び説明
1

result(必須)

これは結果オブジェクトを識別する識別子です。

2

field(必須)

整数値で、元データが必要なフィールドを示します/定義情報のフィールド。

返値

PHP mysqli_fetch_field_direct()関数は、指定されたフィールドの定義情報を含むオブジェクトを返します。指定されたフィールド(数字)が利用できない場合、この関数は以下を返しますFALSE

返されるオブジェクトには以下の属性が含まれます:

  • name - カラム名

  • orgname - オリジナルのカラム名(エイリアスが指定されている場合)

  • table - テーブル名

  • orgtable - オリジナルのテーブル名(エイリアスが指定されている場合)

  • def - このフィールドのデフォルト値

  • max_length - フィールドの最大幅

  • length - テーブル定義で指定されたフィールドの幅

  • charsetnr - フィールドの文字セットID

  • flags - フィールドのビットフラグ

  • type - フィールドのデータタイプ

  • decimals - の整数フィールドで、小数点以下の桁数

PHPバージョン

この関数は最初にPHPバージョン5に導入され、すべてのより高いバージョンで使用できます。

オンラインサンプル

以下の例は、mysqli_fetch_field_direct()関数の使用法(手続き指向スタイル)は、結果セットの第三のフィールド(列)のメタデータを返し、フィールド名、テーブル、最大長、データタイプ、フィールドの文字セットIDを出力します:

<?php
   $con = mysqli_connect("localhost", "root", "password", "mydb");
   mysqli_query($con, "CREATE TABLE myplayers(ID INT, First_Name VARCHAR(255), Last_Name VARCHAR(255), Place_Of_Birth VARCHAR(255), Country VARCHAR(255))");
   print("テーブルを作成.....\n");
   mysqli_query($con, "INSERT INTO myplayers values(1, 'Sikhar', 'Dhawan', 'Delhi', 'India')");
   mysqli_query($con, "INSERT INTO myplayers values(2, 'Jonathan', 'Trott', 'CapeTown', 'SouthAfrica')");
   mysqli_query($con, "INSERT INTO myplayers values(3, 'Kumara', 'Sangakkara', 'Matale', 'Srilanka')");
   print("レコードを挿入.....\n");
   //テーブルの内容を検索
   $res = mysqli_query($con, "SELECT * FROM myplayers");
   //第3個のフィールドのメタデータ
   $info = mysqli_fetch_field_direct($res, 2);
   print("名前: ".$info->name."\n");
   print("テーブル: ".$info->table."\n");
   print("最大長さ: ".$info->max_length."\n");
   print("フラグ: ".$info->flags."\n");
   print("タイプ: ".$info->type."\n");
   print("定義: ".$info->def."\n");
   print("文字セット: ".$info->charsetnr."\n");
   //ステートメントを終了
   mysqli_free_result($res);
   //接続を閉じる
   mysqli_close($con);
?>

出力結果

テーブルを作成.....
レコードを挿入.....
Name: Last_Name
Table: myplayers
Max Length: 10
Flags: 0
タイプ: 253

オンラインサンプル

オブジェクト指向スタイルでは、この関数の構文は以下の通りです:$result->fetch_field_direct();。以下はオブジェクト指向スタイルのこの関数で、結果セットの特定の第二のフィールド(列)のメタデータを返し、フィールド名、テーブル、最大長、データタイプ、フィールドの文字セットIDを出力します:

<?php
   //接続を確立
   $con = new mysqli("localhost", "root", "password", "mydb");
   $con -> query("CREATE TABLE Test(Name VARCHAR(255), AGE INT)");
   $con -> query("insert into Test values('Raju', 25),('Rahman', 30),('Sarmista', 27)");
   print("テーブルを作成.....\n");
   $stmt = $con -> prepare( "SELECT * FROM Test WHERE Name IN(?, ?)");
   $stmt -> bind_param("ss", $name1, $name2);
   $name1 = 'Raju';
   $name2 = 'Rahman';
   //ステートメントを実行
   $stmt->execute();
   //検索結果
   $result = $stmt->get_result();
   //第二のフィールドのメタデータを取得
   $info = $result->fetch_field_direct(1);
   print("名前: ".$info->name."\n");
   print("テーブル: ".$info->table."\n");
   print("最大長さ: ".$info->max_length."\n");
   print("フラグ: ".$info->flags."\n");
   print("タイプ: ".$info->type."\n");
   print("定義: ".$info->def."\n");
   print("文字セット: ".$info->charsetnr."\n");
   //ステートメントを終了
   $stmt->close();
   //接続を閉じる
   $con->close();
?>

出力結果

テーブルを作成.....
名前: AGE
テーブル: Test
最大長さ: 0
フラグ: 32768
タイプ: 3
定義:
文字セット: 63

PHP MySQLi リファレンスマニュアル