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

# 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

function 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

Exemplo #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

- sqlsrv_get_field() - Obtém dados do campo da linha atualmente selecionada
- sqlsrv_fetch_array() - Retorna uma linha como um array
- sqlsrv_fetch_object() - Recupera a próxima linha de dados em um conjunto de resultados como um objeto

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open