pg_fetch_object
(PHP 4, PHP 5, PHP 7, PHP 8)
pg_fetch_object — Liefert einen Datensatz als Objekt
Beschreibung
Hinweis: Diese Funktion setzt NULL-Felder
auf den PHP-Wert null
.
Von der Geschwindigkeit her ist die Funktion mit
pg_fetch_array() identisch und fast so schnell wie
pg_fetch_row() (der Unterschied ist unwesentlich).
Parameter-Liste
result
-
Eine PgSql\Result-Instanz, die von pg_query(),
pg_query_params() oder pg_execute() (unter anderen) zurückgegeben wurde.
row
-
Die Nummer der Zeile des Abfrageergebnisses, die geholt werden soll.
Die Nummerierung beginnt bei 0. Fehlt dieser Parameter oder ist er
null
, so wird jeweils die nächste Zeile geholt.
class
-
Der Name der Klasse, die instantiiert werden soll. Ein Objekt dieser
Klasse mit den gesetzten Eigenschaften wird zurückgegeben. Fehlt
dieser Parameter, wird eine Objekt der Klasse
stdClass zurückgegeben.
constructor_args
-
Ein optionales array mit Parametern, die an den
Konstruktor von class
übergeben werden.
Rückgabewerte
Ein object, das für jeden Feldnamen des geholten Datensatzes
eine Eigenschaft enthält. NULL
-Werte der Datenbank
werden als null
zurückgegeben.
Bei einem Fehler oder wenn der Parameter row
größer
als die Anzahl der Zeilen im Abfrageergebnis ist oder wenn kein Datensatz
mehr gelesen werden kann, wird false
zurückgegeben.
Fehler/Exceptions
Wenn constructor_args
nicht leer ist, die Klasse
aber keinen Konstruktor hat, wird ein ValueError
geworfen.
Beispiele
Beispiel #1 pg_fetch_object()-Beispiel
<?php
$database = "store";
$db_conn = pg_connect("host=localhost port=5432 dbname=$database");
if (!$db_conn) {
echo "Konnte keine Verbindung zu $database aufbauen.\n";
exit;
}
$qu = pg_query($db_conn, "SELECT * FROM books ORDER BY author");
while ($data = pg_fetch_object($qu)) {
echo $data->author . " (";
echo $data->year . "): ";
echo $data->title . "<br />";
}
pg_free_result($qu);
pg_close($db_conn);
?>