(PHP 4 >= 4.3.0, PHP 5, PHP 7)
pg_fetch_assoc — Lit une ligne de résultat PostgreSQL sous forme de tableau associatif
$result
[, int $row
] )
pg_fetch_assoc() retourne un tableau associatif qui
contient la ligne en cours dans le résultat result
.
pg_fetch_assoc() est équivalent d'appeler
pg_fetch_row() avec PGSQL_ASSOC
comme troisième paramètre (qui est optionnel). Cela retournera seulement un
tableau associatif. Si vous avez besoin d'indices numériques, utilisez
pg_fetch_row().
Note: Cette fonction définit les champs NULL à la valeur PHP
NULL
.
pg_fetch_assoc() n'est pas significativement plus lente que pg_fetch_row() et elle apporte un confort d'utilisation appréciable.
result
Ressource de résultat de requête PostgreSQL, retourné par pg_query(), pg_query_params() ou pg_execute() (entre autres).
row
Numéro de la ligne à récupérer. Les lignes sont numérotées
en commençant à 0. Si l'argument est omis ou s'il vaut NULL
,
la ligne suivante est récupérée.
Un tableau à indice associatif (par nom de champ). Chaque valeur dans le
tableau est représentée comme une chaîne (chaîne de caractères). 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.
Exemple #1 Exemple avec pg_fetch_assoc()
<?php
$conn = pg_pconnect ("dbname=publisher");
if (!$conn) {
echo "Une erreur est survenue.\n";
exit;
}
$result = pg_query ($conn, "SELECT id, auteur, email FROM auteurs");
if (!$result) {
echo "Une erreur est survenue.\n";
exit;
}
while ($row = pg_fetch_assoc($result)) {
echo $row['id'];
echo $row['auteur'];
echo $row['email'];
}
?>