pg_fetch_object
(PHP 4, PHP 5)
pg_fetch_object — Lit une ligne de r�sultat PostgreSQL dans un objet
Description
pg_fetch_object() retourne un objet ainsi que ses propri�t�s qui correspond aux noms des champs de la ligne. La fonction peut optionnellement instancier un objet d'une classe sp�cifique et passer les param�tres au constructeur de cette classe.
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
-
Ressource de r�sultat de requ�te PostgreSQL, retourn�e 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 de 0 en montant. Si l'argument est omis, la ligne suivante est r�cup�r�e.
- result_type
-
Ignor� et obsol�te. Valeur par d�faut : PGSQL_ASSOC
- class_name
-
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�.
- params
-
Param�tre optionnel de type array pour passer des arguments au constructeur de la classe class_name .
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.
Historique
Version | Description |
---|---|
5.0.0 | class_name et params ont �t� ajout�s. L'ancien format du param�tre result_type existe toujours pour des raisons de compatibilit� avec les versions ant�rieures. |
4.3.0 | result_type ne vaut plus PGSQL_BOTH par d�faut, mais PGSQL_ASSOC, depuis que l'index num�rique est devenu ill�gal. |
4.1.0 | Le param�tre row devient optionnel. |
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);
?>
Voir aussi
- pg_query() - Ex�cute une requ�te PostgreSQL
- pg_fetch_array() - Lit une ligne de r�sultat PostgreSQL dans un tableau
- pg_fetch_assoc() - Lit une ligne de r�sultat PostgreSQL sous forme de tableau num�rique
- pg_fetch_row() - Lit une ligne dans un tableau
- pg_fetch_result() - Retourne les valeurs d'un r�sultat