PDOStatement ::フェッチ

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

PDOStatement ::フェッチ - 次の行（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 :: FETCH_ASSOC：結果セットの列索引列名を返します。

• PDO :: FETCH_BOTH（デフォルト）：インデックス配列結果セット0で始まる列名と列番号を返します。

• PDO :: FETCH_BOUNDは：返すTRUE 、PHPの変数をと結合するPDOStatement :: bindColumn（）メソッドを結果セットのカラムに値を割り当てます。

• PDO :: FETCH_CLASS：対応するプロパティのクラス名に結果セット内のクラス、マッピング列名の新しいインスタンスを返すように要求。 場合fetch_style PDO :: FETCH_CLASSTYPE含まれています（ 例：PDO :: FETCH_CLASS | PDO :: FETCH_CLASSTYPEを ）、クラス名が最初のカラムの値によって決定されます

• PDO :: FETCH_INTO：プロパティという名前の結果セットクラスの列にマップされた既存の要求クラスのインスタンスを更新

• PDO :: FETCH_LAZY：PDO :: FETCH_BOTHとPDO :: FETCH_OBJと連携して、オブジェクト変数名を作成するためにアクセスするために使用

• PDO :: FETCH_NUM：結果セットの列のゼロインデックス列番号への復帰

• PDO :: FETCH_OBJは：結果セットのカラム名の匿名オブジェクトに対応するプロパティ名を返します。

cursor_orientation
スクロール可能なカーソルを表すPDOStatementオブジェクトの場合、この値は、呼び出し元に返される行を決定します。 この値は、PDO :: FETCH_ORI_ *シリーズの定数でなければなりません、デフォルトはPDO :: FETCH_ORI_NEXTです。 スクロール可能カーソルを使用してPDOStatementオブジェクトを取得するには、PDO :: prepare（）済みの前処理SQL文を使用する必要があり、PDO :: ATTR_CURSOR属性PDO :: CURSOR_SCROLLを設定します。

オフセット
cursor_orientationパラメータがPDOに設定されているために::スクロール可能なカーソルのFETCH_ORI_ABSを表すPDOStatementオブジェクト、この値は、絶対行番号の行を取得したい結果セットを指定します。
cursor_orientationパラメータがPDO :: FETCH_ORI_RELにスクロール可能なカーソルを表すPDOStatementオブジェクトを設定されている場合、この値は、あなたが取得したい線に対してコールをPDOStatement ::（フェッチ）カーソル位置の前に指定します

戻り値

戻るこの関数（メソッド）の値は、成功した抽出型に依存したとき。 すべての場合において、失敗は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

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