mysql_data_seek

(PHP 4, PHP 5)

mysql_data_seekD�place le pointeur interne de r�sultat MySQL

Description

bool mysql_data_seek ( resource $result , int $row_number )

mysql_data_seek() d�place le pointeur interne de r�sultat, dans le r�sultat associ� � l'identifiant de r�sultat result_identifier . Il le fait pointer � la ligne row_number . Le prochain appel � une fonction MySQL de r�cup�ration de donn�es, comme la fonction mysql_fetch_assoc() retournera cette ligne.

row_number commence � 0. row_number doit �tre une valeur qui va de 0 � mysql_num_rows() - 1. Cependant, si le r�sultat est vide, un row_number de 0 �chouera avec une erreur E_WARNING et mysql_data_seek() retournera FALSE.

Liste de param�tres

result

La ressource de r�sultat qui vient d'�tre �valu�e. Ce r�sultat vient de l'appel � la fonction mysql_query().

row_number

La position de la ligne d�sir�e pour le nouveau pointeur de r�sultats.

Valeurs de retour

Cette fonction retourne TRUE en cas de succ�s, FALSE en cas d'�chec.

Exemples

Exemple #1 Exemple avec mysql_data_seek()

<?php
$link 
mysql_connect('localhost''mysql_user''mysql_password');
if (!
$link) {
    die(
'Connexion impossible : ' mysql_error());
}
$db_selected mysql_select_db('sample_db');
if (!
$db_selected) {
    die(
'S�lection de base de donn�es impossible : ' mysql_error());
}
$query 'SELECT nom_famille, prenom FROM amis';
$result mysql_query($query);
if (!
$result) {
    die(
'Requ�te �chec : ' mysql_error());
}
/* R�cup�ration des lignes en ordre inverse */
for ($i mysql_num_rows($result) - 1$i >= 0$i--) {
    if (!
mysql_data_seek($result$i)) {
        echo 
"Ne peut pointer vers la ligne $i : " mysql_error() . "\n";
        continue;
    }

    if (!(
$row mysql_fetch_assoc($result))) {
        continue;
    }

    echo 
$row['nom_famille'] . ' ' $row['prenom'] . "<br />\n";
}

mysql_free_result($result);
?>

Notes

Note: La fonction mysql_data_seek() peut �tre utilis�e en conjonction avec mysql_query(), mais pas avec la fonction mysql_unbuffered_query().

Voir aussi

  • mysql_query() - Envoie une requ�te � un serveur MySQL
  • mysql_num_rows() - Retourne le nombre de lignes d'un r�sultat MySQL
  • mysql_fetch_row() - Retourne une ligne de r�sultat MySQL sous la forme d'un tableau
  • mysql_fetch_assoc() - Lit une ligne de r�sultat MySQL dans un tableau associatif
  • mysql_fetch_array() - Retourne une ligne de r�sultat MySQL sous la forme d'un tableau associatif, d'un tableau index�, ou les deux
  • mysql_fetch_object() - Retourne une ligne de r�sultat MySQL sous la forme d'un objet