pg_fetch_array
(PHP 4, PHP 5)
pg_fetch_array — Lit une ligne de r�sultat PostgreSQL dans un tableau
Description
pg_fetch_array() retourne un tableau qui contient la ligne demand�e.
pg_fetch_array() est une version �volu�e de pg_fetch_row(). En plus de proposer un tableau � indice num�rique, elle peut aussi enregistrer les donn�es dans un tableau associatif, en utilisant les noms des champs comme cl�s. Ces deux fonctions utilisent le tableau associatif par d�faut.
Note: Cette fonction d�finit les champs NULL � la valeur PHP NULL.
pg_fetch_array() n'est pas significativement plus lente que pg_fetch_row() et elle apporte un confort d'utilisation appr�ciable.
Liste de param�tres
- result
-
Ressource de r�sultat de requ�te PostgreSQL, retourn�e par pg_query(), pg_query_params() ou pg_execute() (entre d'autres).
- row
-
Num�ro de la ligne � r�cup�rer. Les lignes sont num�rot�es de 0 en montant. Si l'argument est omis, la ligne suivante est r�cup�r�e.
- result_type
-
Param�tre optionnel qui contr�le comment sera index� le array retourn�. pg_fetch_array() est une constante, qui peut prendre les valeurs suivantes : PGSQL_ASSOC, PGSQL_NUM et PGSQL_BOTH. En utilisant PGSQL_NUM, pg_fetch_array() retourne un tableau avec des indices num�riques, en utilisant PGSQL_ASSOC retourne uniquement des indices associatifs alors que, PGSQL_BOTH, la valeur par d�faut, retourne � la fois des indices num�riques et associatifs.
Valeurs de retour
Un tableau � indice num�rique (commen�ant � 0), associatif (index� avec le nom des champs) ou les deux. Chaque valeur dans le tableau est repr�sent�e comme une cha�ne (string). Les valeurs NULL de la base de donn�es sont retourn�es NULL.
FALSE est retourn�e si row exc�de le nombre de lignes dans le jeu de r�sultats, n'a plus de ligne disponible ou tout autre erreur.
Historique
| Version | Description |
|---|---|
| 4.1.0 | Le param�tre row devient optionnel. |
| 4.0.0 | Le param�tre result_type est ajout�. |
Exemples
Exemple #1 Exemple avec pg_fetch_array()
<?php
$conn = pg_pconnect ("dbname=publisher");
if (!$conn) {
echo "Erreur de connexion.\n";
exit;
}
$result = pg_query ($conn, "SELECT auteur, email FROM auteurs");
if (!$result) {
echo "Erreur durant la requ�te.\n";
exit;
}
$arr = pg_fetch_array ($result, 0, PGSQL_NUM);
echo $arr[0] . " <- Ligne 1 Auteurs\n";
echo $arr[1] . " <- Ligne 1 E-mail\n";
// Depuis PHP 4.1.0, le param�tre row est optionnel ; NULL peut �tre pass� � la place,
// pour passer un result_type. Les appels successifs � pg_fetch_array
// retournera la ligne suivante.
$arr = pg_fetch_array($result, NULL, PGSQL_ASSOC);
echo $arr["auteur"] . " <- Ligne 2 Auteur\n";
echo $arr["email"] . " <- Ligne 2 E-mail\n";
$arr = pg_fetch_array($result);
echo $arr["auteur"] . " <- Ligne 3 Auteur\n";
echo $arr[1] . " <- Ligne 3 E-mail\n";
?>
Voir aussi
- pg_fetch_row() - Lit une ligne dans un tableau
- pg_fetch_object() - Lit une ligne de r�sultat PostgreSQL dans un objet
- pg_fetch_result() - Retourne les valeurs d'un r�sultat
Suivez l'auteur
