mysql_data_seek
(PHP 4, PHP 5)
mysql_data_seek — D�place le pointeur interne de r�sultat MySQL
Description
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