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);
?>