PHP扩展之MySQLi（mysql_result类）

将结果集中的所有行作为数组返回

说明

• 面向对象风格

  mixed mysqli_result::fetch_all ([ int $resulttype = MYSQLI_NUM ] )

• 过程化风格

  mixed mysqli_fetch_all ( mysqli_result $result [, int $resulttype = MYSQLI_NUM ] )

将结果集中的所有行作为关联数组、数字数组或者两者皆有的形式返回。

参数

• result 由 mysqli::query()，mysqli::store_result() 或 mysqli::use_result() 返回的结果集标识。（仅过程化风格需要此参数）

• resulttype 指定要返回的数组的形式：

  • MYSQLI_NUM 数字索引的数组（默认值）

  • MYSQLI_ASSOC 关联索引的数组

  • MYSQLI_BOTH 关联索引和数字索引皆有

返回值

返回包含结果集的数组。或者 NULL

将结果集中的一行作为数组返回（数字索引和关联索引皆有）

说明

• 面向对象风格

  mixed mysqli_result::fetch_array ([ int $resulttype = MYSQLI_BOTH ] )

• 过程化风格

  mixed mysqli_fetch_array ( mysqli_result $result [, int $resulttype = MYSQLI_BOTH ] )

将结果集中的一行作为关联数组、数字数组或者两者皆有的形式返回。

重复调用此函数可以获得结果集中的所有行

此方法返回的字段名大小写敏感

此方法将 NULL 字段 设置为 PHP NULL 值

参数

• result 由 mysqli::query()，mysqli::store_result() 或 mysqli::use_result() 返回的结果集标识。（仅过程化风格需要此参数）

• resulttype 指定要返回的数组的形式：

  • MYSQLI_NUM 数字索引的数组，与 mysqli::fetch_row() 等效

  • MYSQLI_ASSOC 关联索引的数组，与 mysqli::fetch_assoc() 等效

  • MYSQLI_BOTH 关联索引和数字索引皆有（默认值）

返回值

返回数组形式的结果集中的一行。或者 NULL

将结果集中的一行作为关联索引的数组返回

fetch_assoc()

参见 fetch_array()

将结果集中的一行作为数字索引的数组返回

fetch_row()

参见 fetch_array()

将结果集中的一行作为对象返回

说明

• 面向对象风格

  object mysqli_result::fetch_object ([ string $class_name = "stdClass" [, array $params ]] )

• 过程化风格

  object mysqli_fetch_object ( mysqli_result $result [, string $class_name = "stdClass" [, array $params ]] )

将结果集中的一行作为对象返回。

重复调用此函数可以获得结果集中的所有行。

此方法返回的字段名大小写敏感

此方法将 NULL 字段 设置为 PHP NULL 值

参数

• result 由 mysqli::query()，mysqli::store_result() 或 mysqli::use_result() 返回的结果集标识。（仅过程化风格需要此参数）

• class_name 指定要实例化的类名称，如果没有指定，则返回 stdclass 对象。结果集的字段及其值将作为对象的属性和值。此方法在调用指定的类的构造方法之前设置对象属性

• params 传递给第二个参数指定的类的构造函数的可选参数数组。

返回值

返回对象形式的结果集中的一行。或者 NULL

返回结果集中的下一个字段

说明

• 面向对象风格

  object mysqli_result::fetch_field ( void )

• 过程化风格

  object mysqli_fetch_field ( mysqli_result $result )

将结果集的一列返回为对象。重复调用此函数客户获得结果集中所有列的信息。

参数

• result 由 mysqli::query()，mysqli::store_result() 或 mysqli::use_result() 返回的结果集标识。（仅过程化风格需要此参数）

返回值

返回包含字段定义信息的对象；如果没有可用的字段信息，则返回 false

• name 字段名称

• orgname 如果指定了别名，则为原始列名称

• table 此字段所属表的表名称（如果不是计算结果）

• orgtable 如果指定了别名，则为原始表名称

• def 保留为默认值，当前始终是空字符串 ''

• db 所属的库

• catalog 目录名（当前总是 ‘def’）

• max_length 结果集中该字段实际的最大宽度

• length 表定义中指定的字段的宽度

• charsetnr 字段的字符集编号

• flags 表示字段位标识的整数

• type 用于此字段的数据类型

• decimals 使用的小数位数（对于整数字段）

返回指定偏移量的字段信息

说明

• 面向对象风格

  object mysqli_result::fetch_field_direct ( int $fieldnr )

• 面向过程风格

  object mysqli_fetch_field_direct ( mysqli_result $result , int $fieldnr )

此函数的作用与 mysqli::fetch_field() 函数的作用相同，其唯一区别是，可以通过参数 fieldnr 指定要返回的字段。相当于 mysqli::field_seek() + mysqli::fetch_field()

返回表示结果集中所有字段对象组成的数组

fetch_fields()

此函数的作用与 mysqli::fetch_field() 函数的作用相同，其唯一区别是，不必每次为每个字段返回一个对象，而是将列作为对象数组返回。

设置结果集中的字段偏移量

说明

• 面向对象风格

  bool mysqli_result::field_seek ( int $fieldnr )

• 过程化风格

  bool mysqli_field_seek ( mysqli_result $result , int $fieldnr )

将结果集中的字段指针设置为指定的偏移量。下次调用 mysqli::fetch_field() 将检索与该偏移量关联的列的字段信息。

参数

• result 由 mysqli::query()，mysqli::store_result() 或 mysqli::use_result() 返回的结果集标识。（仅过程化风格需要此参数）

• fieldnr 字段编号，取值范围为 0 到 字段数-1

返回值

true 或 false

设置结果集中的行的偏移量

说明

• 面向对象风格

  bool mysqli_result::data_seek ( int $offset )

• 过程化风格

  bool mysqli_data_seek ( mysqli_result $result , int $offset )

将结果集中的行指针设置为指定的偏移量。下次调用 mysqli::fetch_array() 将检索与该偏移量关联的行的数据。

参数

• result 由 mysqli::query()，mysqli::store_result() 或 mysqli::use_result() 返回的结果集标识。（仅过程化风格需要此参数）

• offset 行编号，取值范围为 0 到 总行数-1

返回值

true 或 false

释放与结果集关联的内存

说明

• 面向对象风格

  void mysqli_result::free ( void )
  void mysqli_result::close ( void )
  void mysqli_result::free_result ( void )

• 过程化风格

  void mysqli_free_result ( mysqli_result $result )

释放与结果集关联的内存，当不再需要结果对象时，应始终使用此函数释放结果

参数

• result 由 mysqli::query()，mysqli::store_result() 或 mysqli::use_result() 返回的结果集标识。（仅过程化风格需要此参数）

返回值

没有返回值

返回总列数

说明

• 面向对象风格

  int $mysqli_result->field_count ;

• 过程化风格

  int mysqli_num_fields ( mysqli_result $result )

返回总列数

参数

• result 由 mysqli::query()，mysqli::store_result() 或 mysqli::use_result() 返回的结果集标识。（仅过程化风格需要此参数）

返回值

返回总列数

返回总行数

说明

• 面向对象风格

  int $mysqli_result->num_rows  ;

• 过程化风格

  int mysqli_num_rows ( mysqli_result $result )

返回总行数

参数

• result 由 mysqli::query()，mysqli::store_result() 或 mysqli::use_result() 返回的结果集标识。（仅过程化风格需要此参数）

返回值

返回总行数

返回当前字段的偏移量

说明

• 面向对象风格

  int $mysqli_result->current_field ;

• 过程化风格

  int mysqli_field_tell ( mysqli_result $result )

返回当前字段的偏移量

参数

• result 由 mysqli::query()，mysqli::store_result() 或 mysqli::use_result() 返回的结果集标识。（仅过程化风格需要此参数）

返回值

返回当前字段的偏移量

返回当前行每一列的长度

说明

• 面向对象风格

  array $mysqli_result->lengths;

• 过程化风格

  array mysqli_fetch_lengths ( mysqli_result $result )

返回当前行每一列的长度

参数

• result 由 mysqli::query()，mysqli::store_result() 或 mysqli::use_result() 返回的结果集标识。（仅过程化风格需要此参数）

返回值

返回一个记录了当前行的每一列的长度的数组