array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.sqlsrv-fetch.php', 1 => 'sqlsrv_fetch', 2 => 'Rend la prochaine ligne d\'un jeu de résultats disponible pour lecture', ), 'up' => array ( 0 => 'ref.sqlsrv.php', 1 => 'Fonctions SQLSRV', ), 'prev' => array ( 0 => 'function.sqlsrv-execute.php', 1 => 'sqlsrv_execute', ), 'next' => array ( 0 => 'function.sqlsrv-fetch-array.php', 1 => 'sqlsrv_fetch_array', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/sqlsrv/functions/sqlsrv-fetch.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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. Utiliser 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. 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