sqlsrv_fetch

(No version information available, might only be in Git)

sqlsrv_fetch — Torna a próxima linha em um conjunto de resultados disponível para leitura

Descrição

sqlsrv_fetch(resource $stmt, int $row = ?, int $offset = ?): mixed

Torna a próxima linha em um conjunto de resultados disponível para leitura. Use sqlsrv_get_field() para ler os campos da linha.

Parâmetros

stmt

Um recurso de declaração criado executando sqlsrv_query() ou sqlsrv_execute().

row

A linha a ser acessada. Este parâmetro só pode ser usado se a declaração especificada foi preparada com um cursor rolável. Nesse caso, esse parâmetro pode assumir um dos seguintes valores:

  • SQLSRV_SCROLL_NEXT
  • SQLSRV_SCROLL_PRIOR
  • SQLSRV_SCROLL_FIRST
  • SQLSRV_SCROLL_LAST
  • SQLSRV_SCROLL_ABSOLUTE
  • SQLSRV_SCROLL_RELATIVE
offset

Especifica a linha a ser acessada se o parâmetro row for definido como SQLSRV_SCROLL_ABSOLUTE ou SQLSRV_SCROLL_RELATIVE. Observe que a primeira linha em um conjunto de resultados tem índice 0.

Valor Retornado

Retorna true se a próxima linha de um conjunto de resultados for recuperada com sucesso, false se ocorrer um erro e null se não houver mais linhas no conjunto de resultados.

Exemplos

Example #1 Exemplo de sqlsrv_fetch()

O exemplo a seguir demonstra como recuperar uma linha com sqlsrv_fetch() e obter os campos da linha com sqlsrv_get_field(). 

<?php
$serverName = "serverName\sqlexpress";
$connectionInfo = array( "Database"=>"dbName", "UID"=>"username", "PWD"=>"password");
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if( $conn === false ) {
     die( print_r( sqlsrv_errors(), true));
}

$sql = "SELECT Name, Comment
        FROM Table_1
        WHERE ReviewID=1";
$stmt = sqlsrv_query( $conn, $sql);
if( $stmt === false ) {
     die( print_r( sqlsrv_errors(), true));
}

// Torna a primeira (e neste caso, única) linha do conjunto de resultados disponível para leitura.
if( sqlsrv_fetch( $stmt ) === false) {
     die( print_r( sqlsrv_errors(), true));
}

// Obter os campos da linha. Os índices dos campos começam em 0 e devem ser recuperados na ordem.
// A recuperação de campos da linha pelo nome não é suportada por sqlsrv_get_field.
$name = sqlsrv_get_field( $stmt, 0);
echo "$name: ";

$comment = sqlsrv_get_field( $stmt, 1);
echo $comment;
?>

Veja Também