PDOStatement::fetch

PHP PDO 参考手册PHP PDO-Referenzhandbuch

PDOStatement::fetch — Ruft die nächste Zeile aus einer Ergebnismenge ab (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)


Beschreibung

Syntax

mixed PDOStatement::fetch ([ int $fetch_style [, int $cursor_orientation = PDO::FETCH_ORI_NEXT [, int $cursor_offset = 0 ]]] )

Ruft die nächste Zeile aus einer Ergebnismenge ab, die einem PDOStatement-Objekt zugeordnet ist. Der Parameter fetch_style bestimmt, wie PDO die Zeile zurückgibt.


Parameters

fetch_style

Steuert, wie die nächste Zeile an den Aufrufer zurückgegeben wird. Dieser Wert muss eine der PDO::FETCH_*-Konstanten sein; standardmäßig wird der Wert von PDO::ATTR_DEFAULT_FETCH_MODE verwendet (der standardmäßig PDO::FETCH_BOTH ist).

  • PDO::FETCH_ASSOC: gibt ein Array zurück, das durch die Spaltennamen der Ergebnismenge indiziert ist

  • PDO::FETCH_BOTH(Standard): gibt ein Array zurück, das sowohl durch die Spaltennamen der Ergebnismenge als auch durch nullbasierte Spaltennummern indiziert ist

  • PDO::FETCH_BOUND: liefertTRUE, und weist die Spaltenwerte in der Ergebnismenge den PHP-Variablen zu, die durch die Methode PDOStatement::bindColumn() gebunden sind.

  • PDO::FETCH_CLASS: gibt eine neue Instanz der angeforderten Klasse zurück und ordnet die Spalten der Ergebnismenge den entsprechenden Eigenschaftsnamen in der Klasse zu. Wennfetch_stylePDO::FETCH_CLASSTYPE enthält (z. B.PDO::FETCH_CLASS | PDO::FETCH_CLASSTYPE), wird der Klassenname durch den Wert der ersten Spalte bestimmt

  • PDO::FETCH_INTO: aktualisiert eine vorhandene Instanz der angeforderten Klasse und ordnet die Spalten des Resultsets den benannten Eigenschaften in der Klasse zu

  • PDO::FETCH_LAZY: wird in Kombination mitPDO::FETCH_BOTHundPDO::FETCH_OBJverwendet und erstellt Objektvariablennamen für den Zugriff

  • PDO::FETCH_NUM: gibt ein Array zurück, das über 0-basierte Spaltennummern des Resultsets indiziert ist

  • PDO::FETCH_OBJ: gibt ein anonymes Objekt zurück, dessen Eigenschaftsnamen den Spaltennamen des Resultsets entsprechen

cursor_orientation
Für einen scrollbaren Cursor, der durch ein PDOStatement-Objekt dargestellt wird, bestimmt dieser Wert, welche Zeile an den Aufrufer zurückgegeben wird. Dieser Wert muss eine der PDO::FETCH_ORI_*-Konstanten sein, standardmäßig PDO::FETCH_ORI_NEXT. Damit das PDOStatement-Objekt einen scrollbaren Cursor verwendet, müssen Sie beim Vorbereiten der SQL-Anweisung mit PDO::prepare() das Attribut PDO::ATTR_CURSOR auf PDO::CURSOR_SCROLL setzen.

offset
Für einen scrollbaren Cursor, der durch ein PDOStatement-Objekt dargestellt wird, wobei der Parameter cursor_orientation auf PDO::FETCH_ORI_ABS gesetzt ist, gibt dieser Wert die absolute Zeilennummer der Zeile an, die im Resultset abgerufen werden soll.
Für einen scrollbaren Cursor, der durch ein PDOStatement-Objekt dargestellt wird, wobei der Parameter cursor_orientation auf PDO::FETCH_ORI_REL gesetzt ist, gibt dieser Wert die Position der abzurufenden Zeile relativ zur Cursorposition vor dem Aufruf von PDOStatement::fetch() an.


Rückgabewerte

Der von dieser Funktion (Methode) bei Erfolg zurückgegebene Wert hängt vom Fetch-Typ ab. In allen Fällen wird bei einem Fehler FALSE zurückgegeben.


Beispiele

Zeilen mit unterschiedlichen Fetch-Stilen abrufen

<?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");
?>

Das obige Beispiel gibt Folgendes aus:

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

Zeilen mit einem scrollbaren Cursor abrufen

<?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);
?>

Das obige Beispiel gibt Folgendes aus:

Reading forwards:
21    10    5
16    0     5
19    20    10

Reading backwards:
19    20    10
16    0     5
21    10    5

PHP PDO 参考手册PHP PDO-Referenzhandbuch

Andere Erweiterungen