PDOStatement::fetch

Artikel
06/02/2023

Ruft eine Zeile aus einem Resultset ab.

Syntax

  
mixed PDOStatement::fetch ([ $fetch_style[, $cursor_orientation[, $cursor_offset]]] );

Parameter

$fetch_style: Ein optionales ganzzahliges Symbol, das das Format der Zeilendaten angibt. Eine Liste der möglichen Werte für $fetch_style finden Sie im Abschnitt „Anmerkungen“. Der Standardwert ist PDO::FETCH_BOTH. $fetch_style in der Abrufmethode überschreibt die Angabe von $fetch_style in der PDO::query-Methode.

$cursor_orientation: Ein optionales ganzzahliges Symbol, das die Zeile angibt, die abgerufen werden soll, wenn die prepare-Anweisung PDO::ATTR_CURSOR => PDO::CURSOR_SCROLL angibt. Eine Liste der möglichen Werte für $cursor_orientation finden Sie im Abschnitt „Anmerkungen“. Ein Beispiel mit einem bildlauffähigen Cursor finden Sie unter PDO::prepare .

$cursor_offset: : Ein optionales ganzzahliges Symbol, das die Zeile angibt, die abgerufen werden soll, wenn $cursor_orientation entweder PDO::FETCH_ORI_ABS oder PDO::FETCH_ORI_REL und PDO::ATTR_CURSOR PDO::CURSOR_SCROLL ist.

Rückgabewert

Ein gemischter Wert, der eine Zeile oder „false“ zurückgibt.

Bemerkungen

Der Cursor wird automatisch vorgerückt, wenn FETCH aufgerufen wird. Die folgende Tabelle enthält die Liste der möglichen Werte für $fetch_style.

$fetch_style	BESCHREIBUNG
PDO::FETCH_ASSOC	Gibt ein Array an, das von einem Spaltennamen indiziert ist.
PDO::FETCH_BOTH	Gibt ein Array an, das von einem Spaltennamen und einer 0-basierten Reihenfolge indiziert ist. Dies ist die Standardoption.
PDO::FETCH_BOUND	Gibt „true“ zurück und weist die Werte gemäß PDOStatement::bindColumnzu.
PDO::FETCH_CLASS	Erstellt eine Instanz und ordnet Spalten den benannten Eigenschaften zu. Rufen Sie PDOStatement::setFetchMode auf, bevor Sie FETCH aufrufen.
PDO::FETCH_INTO	Aktualisiert eine Instanz der angeforderten Klasse. Rufen Sie PDOStatement::setFetchMode auf, bevor Sie FETCH aufrufen.
PDO::FETCH_LAZY	Erstellt Namen von Variablen während des Zugriffs sowie ein unbenanntes Objekt.
PDO::FETCH_NUM	Gibt ein Array an, das von einer nullbasierten Spaltenreihenfolge indiziert ist.
PDO::FETCH_OBJ	Gibt ein unbenanntes Objekt mit Eigenschaftennamen an, die Spaltennamen zugeordnet sind.

Wenn sich der Cursor am Ende des Resultsets befindet (die letzte Zeile wurde abgerufen und der Cursor befindet sich außerhalb der Begrenzung des Resultsets) und es sich um einen Vorwärtscursor handelt (PDO::ATTR_CURSOR = PDO::CURSOR_FWDONLY), schlagen nachfolgende FETCH-Aufrufe fehl.

Wenn der Cursor bildlauffähig ist (PDO::ATTR_CURSOR = PDO::CURSOR_SCROLL), wird FETCH den Cursor innerhalb der Begrenzung des Resultsets bewegen. Die folgende Tabelle enthält die Liste der möglichen Werte für $cursor_orientation.

$cursor_orientation	BESCHREIBUNG
PDO::FETCH_ORI_NEXT	Ruft die nächste Zeile ab. Dies ist die Standardoption.
PDO::FETCH_ORI_PRIOR	Ruft die vorherige Zeile ab.
PDO::FETCH_ORI_FIRST	Ruft die erste Zeile ab.
PDO::FETCH_ORI_LAST	Ruft die letzte Zeile ab.
PDO::FETCH_ORI_ABS, num	Ruft die in $cursor_offset angeforderte Zeile über die Zeilennummer ab.
PDO::FETCH_ORI_REL, num	Ruft die in $cursor_offset angeforderte Zeile über die relative Position von der aktuellen Position ab.

Wenn der für $cursor_offset oder $cursor_orientation angegebene Wert eine Position außerhalb der Grenzen des Resultsets ergibt, tritt ein Fehler beim Abruf auf.

Unterstützung für PDO wurde in Version 2.0 von Microsoft-Treiber für PHP für SQL Serverhinzugefügt.

Beispiel

<?php  
   $server = "(local)";  
   $database = "AdventureWorks";  
   $conn = new PDO( "sqlsrv:server=$server ; Database = $database", "", "");  
  
   print( "\n---------- PDO::FETCH_CLASS -------------\n" );  
   $stmt = $conn->query( "select * from HumanResources.Department order by GroupName" );  
  
   class cc {  
      function __construct( $arg ) {  
         echo "$arg";  
      }  
  
      function __toString() {  
         return $this->DepartmentID . "; " . $this->Name . "; " . $this->GroupName;  
      }  
   }  
  
   $stmt->setFetchMode(PDO::FETCH_CLASS, 'cc', array( "arg1 " ));  
   while ( $row = $stmt->fetch(PDO::FETCH_CLASS)) {   
      print($row . "\n");   
   }  
  
   print( "\n---------- PDO::FETCH_INTO -------------\n" );  
   $stmt = $conn->query( "select * from HumanResources.Department order by GroupName" );  
   $c_obj = new cc( '' );  
  
   $stmt->setFetchMode(PDO::FETCH_INTO, $c_obj);  
   while ( $row = $stmt->fetch(PDO::FETCH_INTO)) {   
      echo "$c_obj\n";  
   }  
  
   print( "\n---------- PDO::FETCH_ASSOC -------------\n" );  
   $stmt = $conn->query( "select * from Person.ContactType where ContactTypeID < 5 " );  
   $result = $stmt->fetch( PDO::FETCH_ASSOC );  
   print_r( $result );  
  
   print( "\n---------- PDO::FETCH_NUM -------------\n" );  
   $stmt = $conn->query( "select * from Person.ContactType where ContactTypeID < 5 " );  
   $result = $stmt->fetch( PDO::FETCH_NUM );  
   print_r ($result );  
  
   print( "\n---------- PDO::FETCH_BOTH -------------\n" );  
   $stmt = $conn->query( "select * from Person.ContactType where ContactTypeID < 5 " );  
   $result = $stmt->fetch( PDO::FETCH_BOTH );  
   print_r( $result );  
  
   print( "\n---------- PDO::FETCH_LAZY -------------\n" );  
   $stmt = $conn->query( "select * from Person.ContactType where ContactTypeID < 5 " );  
   $result = $stmt->fetch( PDO::FETCH_LAZY );  
   print_r( $result );  
  
   print( "\n---------- PDO::FETCH_OBJ -------------\n" );  
   $stmt = $conn->query( "select * from Person.ContactType where ContactTypeID < 5 " );  
   $result = $stmt->fetch( PDO::FETCH_OBJ );  
   print $result->Name;  
   print( "\n \n" );  
  
   print( "\n---------- PDO::FETCH_BOUND -------------\n" );  
   $stmt = $conn->query( "select * from Person.ContactType where ContactTypeID < 5 " );  
   $stmt->bindColumn('Name', $name);  
   $result = $stmt->fetch( PDO::FETCH_BOUND );  
   print $name;  
   print( "\n \n" );  
?>

Weitere Informationen

PDOStatement-Klasse

PDO

Freigeben über