Manuel PHP
Précédent |  | Suivant

# 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 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']; } ?>`

## Voir aussi

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

Précédent | Sommaire | Suivant
pg_fetch_array | Niveau supérieur | pg_fetch_object