PHP mysqli_stmt_result_metadata MySQLi 函数

• 

  定义和用法

  mysqli_stmt_result_metadata - 从准备好的语句返回结果集元数据
• 

  版本支持

  PHP4	PHP5	PHP7
  不支持	支持	支持

• 

  语法

  mysqli_stmt_result_metadata ( mysqli_stmt $stmt )
  

  如果传递给 mysqli_prepare() 的语句产生一个结果集，则 mysqli_stmt_result_metadata() 返回结果对象，该结果对象可用于处理元信息，例如字段总数和单个字段信息。

  注意：可以将此结果集指针作为参数传递给处理结果集元数据的任何基于字段的函数，例如：

  • mysqli_num_fields()
  • mysqli_fetch_field()
  • mysqli_fetch_field_direct()
  • mysqli_fetch_fields()
  • mysqli_field_count()
  • mysqli_field_seek()
  • mysqli_field_tell()
  • mysqli_free_result()

  完成结果集结构后，应将其释放，可以将其传递给mysqli_free_result()来完成。

  注意：mysqli_stmt_result_metadata()返回的结果集仅包含元数据。 它不包含任何行结果。 通过将语句句柄与mysqli_stmt_fetch()结合使用来获得行。

• 

  参数

  参数	必需的	描述
  stmt	是	由 mysqli_stmt_init() 返回的 statement 标识。

• 

  返回值

  返回result对象，如果发生错误则返回FALSE。
• 

  示例

  <?php
  $link = mysqli_connect("localhost", "my_user", "my_password", "test");
  
  mysqli_query($link, "DROP TABLE IF EXISTS friends");
  mysqli_query($link, "CREATE TABLE friends (id int, name varchar(20))");
  
  mysqli_query($link, "INSERT INTO friends VALUES (1,'Hartmut'), (2, 'Ulf')");
  
  $stmt = mysqli_prepare($link, "SELECT id, name FROM friends");
  mysqli_stmt_execute($stmt);
  
  /* get resultset for metadata */
  $result = mysqli_stmt_result_metadata($stmt);
  
  /* retrieve field information from metadata result set */
  $field = mysqli_fetch_field($result);
  
  printf("Fieldname: %s\n", $field->name);
  
  /* close resultset */
  mysqli_free_result($result);
  
  /* close connection */
  mysqli_close($link);
  

• 

  相关函数

  mysqli_prepare() - 准备执行一个 SQL 语句

  mysqli_free_result() - 释放与结果关联的内存