array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.pg-fetch-assoc.php', 1 => 'pg_fetch_assoc', ), 'up' => array ( 0 => 'ref.pgsql.php', 1 => 'Fonctions PostgreSQL', ), 'prev' => array ( 0 => 'function.pg-fetch-array.php', 1 => 'pg_fetch_array', ), 'next' => array ( 0 => 'function.pg-fetch-object.php', 1 => 'pg_fetch_object', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/pgsql/functions/pg-fetch-assoc.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
pg_fetch_assoc — Lit une ligne de résultat PostgreSQL sous forme de tableau associatif
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
Une instance PgSql\Result, 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 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.
Version | Description |
---|---|
8.1.0 |
Le paramètre result attend désormais une instance de
PgSql\Result ; auparavant, une ressource était attendu.
|
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'];
}
?>