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() 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.

Note: row est devenu optionnel depuis PHP 4.1.0.

Liste de paramètres

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 de 0 en montant. Si l'argument est omis, la ligne suivante est récupérée.

Valeurs de retour

Un tableau à indice associatif (par nom de champ). 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.

Exemples

Exemple 2089. 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' ];
}
?>

Voir aussi

pg_fetch_row()
pg_fetch_array()
pg_fetch_object()
pg_fetch_result()