pg_fetch_object
(PHP 4, PHP 5, PHP 7, PHP 8)
pg_fetch_object —
Lit une ligne de résultat PostgreSQL dans un objet
Description
Note: Cette fonction définit les champs NULL à la
valeur PHP null
.
Du point de vue vitesse, la fonction est identique à
pg_fetch_array() et est presque aussi rapide que
pg_fetch_row() (la différence est insignifiante).
Liste de paramètres
result
-
Une 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.
class
-
Le nom de la classe à instancier, fixe les propriétés de celles-ci et
ses valeurs de retour. Si rien n'est spécifié, un objet de style
stdClass est retourné.
constructor_args
-
Paramètre optionnel de type array pour passer des
arguments au constructeur de la classe
class
.
Valeurs de retour
Un objet de type object avec les attributs pour chaque champ
dans le jeu de résultats.
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.
Erreurs / Exceptions
Une ValueError est déclenchée lorsque
l'argument constructor_args
n'est pas vide et que la classe n'a pas de constructeur.
Exemples
Exemple #1 Exemple avec pg_fetch_object()
<?php
$database = 'store';
$db_conn = pg_connect("host=localhost port=5432 dbname=$database");
if (!$db_conn) {
echo "La connexion a la base $database a échouée\n";
exit;
}
$qu = pg_query($db_conn, "SELECT * FROM livres ORDER BY auteur");
while ($data = pg_fetch_object($qu)) {
echo $data->auteur . " (";
echo $data->annee . "): ";
echo $data->titre . "<br />";
}
pg_free_result($qu);
pg_close($db_conn);
?>