天天看點

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

總結

以上就是這篇文章的全部内容了,希望本文的内容對大家的學習或者工作具有一定的參考學習價值,謝謝大家對ZaLou.Cn的支援。