Rend la prochaine ligne d'un jeu de résultats disponible pour lecture

# sqlsrv_fetch

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

sqlsrv_fetch — Rend la prochaine ligne d'un jeu de résultats disponible pour lecture

### Description

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

Rend la prochaine ligne d'un jeu de résultats disponible pour lecture. Utiliser la fonction sqlsrv_get_field() pour lire les champs de la ligne.

### Liste de paramètres

`stmt`
  Une ressource de requête créée par l'exécution de la fonction sqlsrv_query() ou de la fonction sqlsrv_execute().
`row`

  La ligne à traiter. Ce paramètre ne peut être utilisé que si la requête spécifiée a été préparée avec un curseur scrollable. Dans ce cas, ce paramètre peut prendre une des valeurs suivantes :

  - SQLSRV_SCROLL_NEXT
  - SQLSRV_SCROLL_PRIOR
  - SQLSRV_SCROLL_FIRST
  - SQLSRV_SCROLL_LAST
  - SQLSRV_SCROLL_ABSOLUTE
  - SQLSRV_SCROLL_RELATIVE
`offset`
  Spécifie la ligne à traiter si le paramètre row est défini à `SQLSRV_SCROLL_ABSOLUTE` ou `SQLSRV_SCROLL_RELATIVE`. Il est à noter que la première ligne d'un jeu de résultats a l'index 0.

### Valeurs de retour

Retourne `true` si la prochaine ligne du jeu de résultats a été récupérée avec succès, `false` si une erreur survient et `null` s'il n'y a plus de ligne à récupérer dans le jeu de résultats.

### Exemples

Exemple #1 Exemple avec sqlsrv_fetch()

L'exemple suivant montre la façon pour récupérer une ligne avec la fonction sqlsrv_fetch() et pour récupérer les champs de la ligne avec la fonction 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));
    }

    // Récupère la première ligne (et dans ce cas, seulement celle-ci) du jeu de résultats
    // pour lecture.
    if( sqlsrv_fetch( $stmt ) === false) {
         die( print_r( sqlsrv_errors(), true));
    }

    // Récupère les champs de la ligne. Les indices des champs commencent à 0 et
    // doivent être récupérés dans l'ordre.
    // Le fait de récupérer les champs de la ligne par leurs noms n'est pas supporté
    // par la fonction sqlsrv_get_field.
    $name = sqlsrv_get_field( $stmt, 0);
    echo "$name: ";

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

### Voir aussi

- sqlsrv_get_field() - Récupère les données du champ depuis la ligne actuellement sélectionnée
- sqlsrv_fetch_array() - Retourne une ligne sous la forme d'un tableau
- sqlsrv_fetch_object() - Récupère la prochaine ligne de données du jeu de résultats sous la forme d'un objet

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