sqlsrv_fetch
(No version information available, might only be in SVN)
sqlsrv_fetch — Rend la prochaine ligne d'un jeu de résultats disponible pour lecture
Description
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
ouSQLSRV_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()
- <?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