(PHP 4, PHP 5, PHP 7, PHP 8)
pg_fetch_array — Lit une ligne de résultat PostgreSQL dans un tableau
pg_fetch_array() retourne un tableau qui contient la ligne demandée.
pg_fetch_array() est une version évoluée de pg_fetch_row(). En plus de proposer un tableau à indice numérique, elle peut aussi enregistrer les données dans un tableau associatif, en utilisant les noms des champs comme clés. Ces deux fonctions utilisent le tableau associatif par défaut.
Note: Cette fonction définit les champs NULL à la valeur PHP
null.
pg_fetch_array() n'est pas significativement plus lente que pg_fetch_row() et elle apporte un confort d'utilisation appréciable.
resultUne 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.
mode
Un paramètre optionnel qui contrôle la façon dont le array retourné est indexé.
mode est une constante qui peut prendre les valeurs suivantes :
PGSQL_ASSOC, PGSQL_NUM et PGSQL_BOTH.
En utilisant PGSQL_NUM, la fonction retournera un tableau avec des indices numériques,
en utilisant PGSQL_ASSOC, elle retournera seulement des indices associatifs
tandis que PGSQL_BOTH retournera à la fois des indices numériques et associatifs.
Un tableau à indice numérique (commençant à 0), associatif (indexé avec
le nom des champs) ou les deux.
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.
Tenter de récupérer le résultat d'une requête autre que SELECT retournera aussi false.
| 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_array()
<?php
$conn = pg_pconnect ("dbname=publisher");
if (!$conn) {
echo "Erreur de connexion.\n";
exit;
}
$result = pg_query ($conn, "SELECT auteur, email FROM auteurs");
if (!$result) {
echo "Erreur durant la requête.\n";
exit;
}
$arr = pg_fetch_array ($result, 0, PGSQL_NUM);
echo $arr[0] . " <- Ligne 1 Auteurs\n";
echo $arr[1] . " <- Ligne 1 E-mail\n";
// Le paramètre row est optionnel ; NULL peut être passé à la place,
// pour passer un mode. Les appels successifs à pg_fetch_array
// retournera la ligne suivante.
$arr = pg_fetch_array($result, NULL, PGSQL_ASSOC);
echo $arr["auteur"] . " <- Ligne 2 Auteur\n";
echo $arr["email"] . " <- Ligne 2 E-mail\n";
$arr = pg_fetch_array($result);
echo $arr["auteur"] . " <- Ligne 3 Auteur\n";
echo $arr[1] . " <- Ligne 3 E-mail\n";
?>