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

sqlsrv_fetch ( resource `$stmt` [, int `$row` [, int `$offset` ]] ) : mixed

Rend la prochaine ligne d'un jeu de résultats disponible pour lecture. Utilisez la fonction sqlsrv_get_field() pour llire 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`. Notez 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