pg_fetch_array
Lit une ligne de résultat PostgreSQL dans un tableau
&reftitle.description;
arraypg_fetch_array
resourceresult
introw
intresult_type
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.
&database.fetch-null;
pg_fetch_array n'est pas significativement plus lente
que pg_fetch_row et elle apporte un confort
d'utilisation appréciable.
&reftitle.parameters;
result
Ressource de résultat de requête PostgreSQL, retournée par
pg_query, pg_query_params
ou pg_execute (entre d'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.
result_type
Paramètre optionnel qui contrôle comment sera indexé le
array retourné.
pg_fetch_array est une constante, qui peut prendre les
valeurs suivantes : PGSQL_ASSOC,
PGSQL_NUM et PGSQL_BOTH.
En utilisant PGSQL_NUM, pg_fetch_array
retourne un tableau avec des indices numériques, en utilisant
PGSQL_ASSOC retourne uniquement des indices associatifs
alors que, PGSQL_BOTH, la valeur par défaut, retourne
à la fois des indices numériques et associatifs.
&reftitle.returnvalues;
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
(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.
&reftitle.changelog;
&Version;
&Description;
4.1.0
Le paramètre row devient optionnel.
4.0.0
Le paramètre result_type est ajouté.
&reftitle.examples;
Exemple avec pg_fetch_array
]]>
&reftitle.seealso;
pg_fetch_row
pg_fetch_object
pg_fetch_result