sqlsrv_fetch_array

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

    sqlsrv_fetch_array — Retorna uma linha como um array

    Descrição

    sqlsrv_fetch_array(
        resource$stmt,
        int$fetchType = ?,
        int$row = ?,
        int$offset = ?
    ): array

    Retorna a próxima linha disponível de dados como um array associativo, um array numérico ou ambos (o padrão).

    Parâmetros

    stmt

    Um recurso de declaração retornado por sqlsrv_query ou sqlsrv_prepare.

    fetchType

    Uma constante predefinida especificando o tipo de array a ser retornado. Valores possíveis são SQLSRV_FETCH_ASSOC, SQLSRV_FETCH_NUMERIC e SQLSRV_FETCH_BOTH (o padrão).

    Um tipo de busca de SQLSRV_FETCH_ASSOC não deve ser usado ao consumir um conjunto de resultados com várias colunas do mesmo nome.

    row

    Especifica a linha a ser acessada em um conjunto de resultados que usa um cursor rolável. Os valores possíveis são SQLSRV_SCROLL_NEXT, SQLSRV_SCROLL_PRIOR, SQLSRV_SCROLL_FIRST, SQLSRV_SCROLL_LAST, SQLSRV_SCROLL_ABSOLUTE e, SQLSRV_SCROLL_RELATIVE (o padrão). Quando este parâmetro é especificado, o fetchType deve ser definido explicitamente.

    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 um array em caso de sucesso, null se não houver mais linhas para retornar, e false se ocorrer um erro.

    Exemplos

    Exemplo #1 Recuperando um array associativo.

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

    $sql = "SELECT FirstName, LastName FROM SomeTable";
    $stmt = sqlsrv_query( $conn, $sql );
    if(     $stmt === false) {
    die(     print_r( sqlsrv_errors(), true) );
    }

    while(     $row = sqlsrv_fetch_array( $stmt, SQLSRV_FETCH_ASSOC) ) {
    echo     $row['LastName'].", ".$row['FirstName']."<br />";
    }

    sqlsrv_free_stmt( $stmt);
    ?>

    Exemplo #2 Recuperando um array numérico.

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

    $sql = "SELECT FirstName, LastName FROM SomeTable";
    $stmt = sqlsrv_query( $conn, $sql );
    if(     $stmt === false) {
    die(     print_r( sqlsrv_errors(), true) );
    }

    while(     $row = sqlsrv_fetch_array( $stmt, SQLSRV_FETCH_NUMERIC) ) {
    echo     $row[0].", ".$row[1]."<br />";
    }

    sqlsrv_free_stmt( $stmt);
    ?>

    Notas

    Não especificar o fetchType ou usar explicitamente o SQLSRV_FETCH_TYPE constante nos exemplos acima retornará um array que possui chaves associativas e numéricas.

    Se mais de uma coluna for retornada com o mesmo nome, a última coluna terá precedência. Para evitar colisões de nomes de campo, use aliases.

    Se uma coluna sem nome for retornada, a chave associativa para o elemento do array será uma string vazia ("").

    Veja Também

    • sqlsrv_connect() - Abre uma conexão com um banco de dados Microsoft SQL Server
    • sqlsrv_query() - Prepara e executa uma consulta
    • sqlsrv_errors() - Retorna informações de erro e aviso sobre a última operação SQLSRV executada
    • sqlsrv_fetch() - Torna a próxima linha em um conjunto de resultados disponível para leitura
    To Top