mysql_fetch_array
(PHP 4, PHP 5)
mysql_fetch_array — Retourne une ligne de r�sultat MySQL sous la forme d'un tableau associatif, d'un tableau index�, ou les deux
Description
mysql_fetch_array() retourne un tableau qui contient la ligne demand�e dans le r�sultat result et d�place le pointeur de donn�es interne d'un cran.
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().
- result_type
-
Le type de tableau � r�cup�rer. C'est une constante qui peut prendre les valeurs suivantes : MYSQL_ASSOC, MYSQL_NUM, et la valeur par d�faut est MYSQL_BOTH.
Valeurs de retour
Retourne un tableau de cha�nes qui correspond � la ligne r�cup�r�e ou FALSE s'il n'y a plus de lignes. Le type de tableau retourn� d�pend de la d�finition du param�tre result_type . En utilisant MYSQL_BOTH (d�faut), vous r�cup�rerez un tableau contenant des indices associatifs et num�riques. En utilisant MYSQL_ASSOC, vous ne r�cup�rerez que les indices associatifs (comme le fonctionnement de la fonction mysql_fetch_assoc()), en utilisant MYSQL_NUM, vous ne r�cup�rerez que les indices num�riques (comme le fonctionnement de la fonctionmysql_fetch_row()).
Si plusieurs colonnes portent le m�me nom, la derni�re colonne aura la priorit�. Pour acc�der aux autres colonnes du m�me nom, vous devez utiliser l'index num�rique, ou faire un alias pour chaque colonne. Pour les alias de colonnes, vous ne pourrez pas acc�der aux contenus avec les noms originaux des colonnes.
Exemples
Exemple #1 Requ�te avec duplication de nom de colonnes
SELECT table1.field AS foo, table2.field AS bar FROM table1, table2
Exemple #2 mysql_fetch_array() avec MYSQL_NUM
<?php
mysql_connect("localhost", "mysql_user", "mysql_password") or
die("Impossible de se connecter : " . mysql_error());
mysql_select_db("mydb");
$result = mysql_query("SELECT id, name FROM mytable");
while ($row = mysql_fetch_array($result, MYSQL_NUM)) {
printf("ID : %s Nom : %s", $row[0], $row[1]);
}
mysql_free_result($result);
?>
Exemple #3 mysql_fetch_array() avec MYSQL_ASSOC
<?php
mysql_connect("localhost", "mysql_user", "mysql_password") or
die("Impossible de se connecter : " . mysql_error());
mysql_select_db("mydb");
$result = mysql_query("SELECT id, name FROM mytable");
while ($row = mysql_fetch_array($result, MYSQL_ASSOC)) {
printf("ID : %s Nom : %s", $row["id"], $row["name"]);
}
mysql_free_result($result);
?>
Exemple #4 mysql_fetch_array() avec MYSQL_BOTH
<?php
mysql_connect("localhost", "mysql_user", "mysql_password") or
die("Impossible de se connecter : " . mysql_error());
mysql_select_db("mydb");
$result = mysql_query("SELECT id, name FROM mytable");
while ($row = mysql_fetch_array($result, MYSQL_BOTH)) {
printf ("ID : %s Nom : %s", $row[0], $row["name"]);
}
mysql_free_result($result);
?>
Notes
Note: Performance
Une chose importante � noter est que l'utilisation de mysql_fetch_array() n'est pas significativement plus lent que l'utilisation de mysql_fetch_row(), alors qu'il fournit des valeurs significatives ajout�es.
Note: Les noms des champs retourn�s par cette fonction sont sensibles � la casse.
Note: Cette fonction d�finit les champs NULL � la valeur PHP NULL.
Voir aussi
- 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_data_seek() - D�place le pointeur interne de r�sultat MySQL
- mysql_query() - Envoie une requ�te � un serveur MySQL