pg_fetch_all
<<<
pg_fetch_array pg_fetch_assoc
>>>

6.31 PostgreSQL
6 Référence des fonctions
 Manuel PHP

Introduction
Pré-requis
Installation
Configuration à l'exécution
Types de ressources
Constantes pré-définies
Notes
Exemples
pg_affected_rows
pg_cancel_query
pg_client_encoding
pg_close
pg_connect
pg_connection_busy
pg_connection_reset
pg_connection_status
pg_convert
pg_copy_from
pg_copy_to
pg_dbname
pg_delete
pg_end_copy
pg_escape_bytea
pg_escape_string
pg_execute
pg_fetch_all_columns
pg_fetch_all
->pg_fetch_array
pg_fetch_assoc
pg_fetch_object
pg_fetch_result
pg_fetch_row
pg_field_is_null
pg_field_name
pg_field_num
pg_field_prtlen
pg_field_size
pg_field_type_oid
pg_field_type
pg_free_result
pg_get_notify
pg_get_pid
pg_get_result
pg_host
pg_insert
pg_last_error
pg_last_notice
pg_last_oid
pg_lo_close
pg_lo_create
pg_lo_export
pg_lo_import
pg_lo_open
pg_lo_read_all
pg_lo_read
pg_lo_seek
pg_lo_tell
pg_lo_unlink
pg_lo_write
pg_meta_data
pg_num_fields
pg_num_rows
pg_options
pg_parameter_status
pg_pconnect
pg_ping
pg_port
pg_prepare
pg_put_line
pg_query_params
pg_query
pg_result_error_field
pg_result_error
pg_result_seek
pg_result_status
pg_select
pg_send_execute
pg_send_prepare
pg_send_query_params
pg_send_query
pg_set_client_encoding
pg_set_error_verbosity
pg_trace
pg_transaction_status
pg_tty
pg_unescape_bytea
pg_untrace
pg_update
pg_version

6.31.28 pg_fetch_array() Lit une ligne de résultat PostgreSQL dans un tableau

[ Exemples avec pg_fetch_array ]   PHP 3 >= 3.0.1, PHP 4, PHP 5

array  pg_fetch_array ( resource   result , int   row , int   result_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.

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.

Note

row est devenu optionnel depuis PHP 4.1.0.

Note

result_type a été ajouté en PHP 4.0.0.

    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.

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.

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";

// Depuis PHP 4.1.0, le paramètre row est optionnel ; NULL peut être passé à la place,
// pour passer un result_type. 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";

?>

<< pg_fetch_array >>
pg_fetch_all PostgreSQL pg_fetch_assoc