pg_fetch_assoc

(PHP 4 >= 4.3.0, PHP 5)

pg_fetch_assoc --  Lit une ligne de résultat PostgreSQL sous forme de tableau numérique

Description

array pg_fetch_assoc ( resource result [, int row] )

pg_fetch_assoc() retourne un tableau associatif qui contient la ligne en cours dans le résultat result. pg_fetch_assoc() retourne FALSE si il n'y a plus de lignes.

pg_fetch_assoc() est une version améliorée de pg_fetch_row(). En plus de stocker les valeurs dans un tableau à index numérique, elle stocke aussi les données dans un tableau associatif, en utilisant les noms de colonnes comme index. Si vous n'avez pas l'utilité des index numériques, utilisez plutôt pg_fetch_row().

Note : Cette fonction définie les champs NULL à la valeur PHP NULL.

row est le numéro de ligne à lire. Par défaut, il vaut 0.

pg_fetch_assoc() n'est pas significativement plus lente que pg_fetch_row(), et elle apporte un confort d'utilisation appréciable.

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, author, email FROM authors");
if (!
$result) {
    echo
"Une erreur est survenue.\n";
    exit;
}

while (
$row = pg_fetch_assoc($result)) {
    echo
$row['id'];
    echo
$row['author'];
    echo
$row['email'];
}
?>

Note : Depuis 4.1.0, row est devenu optionnel. L'appel à pg_fetch_assoc() incrémentera le compteur de lignes interne de 1.

Voir aussi pg_fetch_row(), pg_fetch_array(), pg_fetch_object() et pg_fetch_result().