PDOStatement::fetch

Descarregar o driver PHP

Recupera uma linha de um conjunto de resultados.

Syntax

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

Parâmetros

$ fetch_style: Um símbolo opcional (inteiro) que especifica o formato dos dados da linha. Consulte a secção de Observações para a lista de possíveis valores para $fetch_style. O padrão é PDO::FETCH_BOTH. $ fetch_style no método fetch substituirá o $fetch_style especificado no método PDO::query.

$ cursor_orientation: Um símbolo opcional (inteiro) que indica a linha a recuperar quando a instrução prepare especifica PDO::ATTR_CURSOR => PDO::CURSOR_SCROLL. Consulte a secção Observações para a lista de possíveis valores para $cursor_orientation. Consulte PDO::p repare para um exemplo usando um cursor scrollável.

$ cursor_offset: Um símbolo opcional (inteiro) que especifica a linha a buscar quando $cursor_orientation é PDO::FETCH_ORI_ABS ou PDO::FETCH_ORI_REL e PDO::ATTR_CURSOR é PDO::CURSOR_SCROLL.

Valor de retorno

Um valor misto que devolve uma linha ou falso.

Observações

O cursor avança automaticamente quando se chama o fetch. A tabela seguinte contém a lista de possíveis valores de $fetch_style .

Se o cursor estiver no final do conjunto de resultados (a última linha foi recuperada e o cursor avançou para além do limite do conjunto de resultados) e se o cursor for apenas para frente (PDO::ATTR_CURSOR = PDO::CURSOR_FWDONLY), as chamadas de busca subsequentes falharão.

Se o cursor for deslocável (PDO::ATTR_CURSOR = PDO::CURSOR_SCROLL), a busca irá mover o cursor dentro do limite do conjunto de resultados. A tabela seguinte contém a lista dos possíveis valores de $cursor_orientation .

Se o valor especificado para $cursor_offset ou $cursor_orientation resultar numa posição fora do limite do conjunto de resultados, a busca falhará.

O suporte para PDO foi adicionado na versão 2.0 dos Microsoft Drivers for PHP para SQL Server.

Example

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

Conteúdo relacionado

• Classe PDOStatement
• PDO