pg_fetch_object
(PHP 4, PHP 5, PHP 7, PHP 8)
pg_fetch_object — Liefert einen Datensatz als Objekt
Beschreibung
pg_fetch_object
( resource $result
, int $row
= ?
, int $result_type
= PGSQL_ASSOC
) : object
pg_fetch_object
( resource $result
, int $row
= ?
, string $class_name
= ?
, array $params
= ?
) : object
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
-
Die PostgreSQL-Verbindungskennung, die (unter anderem) von den
Funktionen pg_query(),
pg_query_params() oder
pg_execute() 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.
-
result_type
-
Ist veraltet und wird ignoriert.
-
class_name
-
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.
-
params
-
Ein optionales array mit Parametern, die an den
Konstruktor von class_name
ü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.
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);
?>