PHP PDOStatement::fetch讲解

pdostatement::fetch

pdostatement::fetch — 从结果集中获取下一行(php 5 >= 5.1.0, pecl pdo >= 0.1.0)

说明

语法

mixed pdostatement::fetch ([ int $fetch_style [, int $cursor_orientation = pdo::fetch_ori_next [, int $cursor_offset = 0 ]]] )

从一个 pdostatement 对象相关的结果集中获取下一行。fetch_style 参数决定 pod 如何返回行。

参数

fetch_style

控制下一行如何返回给调用者。此值必须是 pdo::fetch_* 系列常量中的一个，缺省为 pdo::attr_default_fetch_mode 的值 （默认为 pdo::fetch_both ）。

• _pdo::fetchassoc ：返回一个索引为结果集列名的数组
• _pdo::fetchboth （默认）：返回一个索引为结果集列名和以0开始的列号的数组
• _pdo::fetchbound ：返回 true ，并分配结果集中的列值给pdostatement::bindcolumn() 方法绑定的 php 变量。
• _pdo::fetchclass ：返回一个请求类的新实例，映射结果集中的列名到类中对应的属性名。如果 fetch_style 包含 pdo::fetch_classtype（例如： _pdo::fetch_class | pdo::fetchclasstype ），则类名由第一列的值决定
• _pdo::fetchinto ：更新一个被请求类已存在的实例，映射结果集中的列到类中命名的属性
• _pdo::fetchlazy ：结合使用 _pdo::fetchboth 和 _pdo::fetchobj ，创建供用来访问的对象变量名
• _pdo::fetchnum ：返回一个索引为以0开始的结果集列号的数组
• _pdo::fetchobj ：返回一个属性名对应结果集列名的匿名对象

cursor_orientation

• 对于 一个 pdostatement 对象表示的可滚动游标，该值决定了哪一行将被返回给调用者。此值必须是 pdo::fetchori* 系列常量中的一个，默认为 pdo::fetch_ori_next。要想让 pdostatement 对象使用可滚动游标，必须在用 pdo::prepare() 预处理sql语句时，设置 pdo::attr_cursor 属性为 pdo::cursor_scroll。

offset

• 对于一个 cursor_orientation 参数设置为 pdo::fetch_ori_abs 的pdostatement 对象代表的可滚动游标，此值指定结果集中想要获取行的绝对行号。
• 对于一个 cursor_orientation 参数设置为 pdo::fetch_ori_rel 的pdostatement 对象代表的可滚动游标，此值指定想要获取行相对于调用 pdostatement::fetch() 前游标的位置

返回值

此函数（方法）成功时返回的值依赖于提取类型。在所有情况下，失败都返回 false 。

实例

用不同的提取方式获取行

<?php
$sth = $dbh->prepare("select name, colour from fruit");
$sth->execute();
/* 运用 pdostatement::fetch 风格 */
print("pdo::fetch_assoc: ");
print("return next row as an array indexed by column name\n");
$result = $sth->fetch(pdo::fetch_assoc);
print_r($result);
print("\n");
print("pdo::fetch_both: ");
print("return next row as an array indexed by both column name and number\n");
$result = $sth->fetch(pdo::fetch_both);
print_r($result);
print("\n");
print("pdo::fetch_lazy: ");
print("return next row as an anonymous object with column names as properties\n");
$result = $sth->fetch(pdo::fetch_lazy);
print_r($result);
print("\n");
print("pdo::fetch_obj: ");
print("return next row as an anonymous object with column names as properties\n");
$result = $sth->fetch(pdo::fetch_obj);
print $result->name;
print("\n");
?>

以上实例会输出：

pdo::fetch_assoc: return next row as an array indexed by column name
array
(
  [name] => apple
  [colour] => red
)
pdo::fetch_both: return next row as an array indexed by both column name and number
array
(
  [name] => banana
  [0] => banana
  [colour] => yellow
  [1] => yellow
)
pdo::fetch_lazy: return next row as an anonymous object with column names as properties
pdorow object
(
  [name] => orange
  [colour] => orange
)
pdo::fetch_obj: return next row as an anonymous object with column names as properties
kiwi

使用一个可滚动游标获取行

<?php
function readdataforwards($dbh) {
 $sql = 'select hand, won, bet from mynumbers order by bet';
 try {
  $stmt = $dbh->prepare($sql, array(pdo::attr_cursor => pdo::cursor_scroll));
  $stmt->execute();
  while ($row = $stmt->fetch(pdo::fetch_num, pdo::fetch_ori_next)) {
   $data = $row[0] . "\t" . $row[1] . "\t" . $row[2] . "\n";
   print $data;
  }
  $stmt = null;
 }
 catch (pdoexception $e) {
  print $e->getmessage();
 }
}
function readdatabackwards($dbh) {
 $sql = 'select hand, won, bet from mynumbers order by bet';
 try {
  $stmt = $dbh->prepare($sql, array(pdo::attr_cursor => pdo::cursor_scroll));
  $stmt->execute();
  $row = $stmt->fetch(pdo::fetch_num, pdo::fetch_ori_last);
  do {
   $data = $row[0] . "\t" . $row[1] . "\t" . $row[2] . "\n";
   print $data;
  } while ($row = $stmt->fetch(pdo::fetch_num, pdo::fetch_ori_prior));
  $stmt = null;
 }
 catch (pdoexception $e) {
  print $e->getmessage();
 }
}
print "reading forwards:\n";
readdataforwards($conn);
print "reading backwards:\n";
readdatabackwards($conn);
?>

以上实例会输出：

reading forwards:
21    10    5
16    0     5
19    20    10
reading backwards:
19    20    10
16    0     5
21    10    5

总结

以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作具有一定的参考学习价值，谢谢大家对的支持。如果你想了解更多相关内容请查看下面相关链接