PHP Handbuch
Zurück |  | Weiter

# pg_fetch_object

(PHP 3 >= 3.0.1, PHP 4, PHP 5)

pg_fetch_object -- Holt einen Datensatz als Objekt

## Beschreibung

object pg_fetch_object ( resource result [, int row [, int result_type]] )
object pg_fetch_object ( resource result [, int row [, string class_name [, array params]]] )

pg_fetch_object() gibt ein Objekt zurück, dessen Eigenschaften mit den Feldern des geholten Datensatzes übereinstimmen. Optional kann pg_fetch_object() ein Objekt der Klasse `class_name` instantiieren, indem die Parameter `params` an den Konstruktor dieser Klasse übergeben werden.

> Anmerkung: 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).

> Anmerkung: `row` wurde ab PHP 4.1.0 optional.

> Anmerkung: `result_type` die Standardeinstellung wechselte von PHP 4.3.0 an von `PGSQL_BOTH` auf `PGSQL_ASSOC`, da numerische Indizes bei Objekten nicht erlaubt sind.

> Anmerkung: Die Parameter `class_name` und `params` kamen in PHP 5.0 hinzu. Die herkömmliche Form mit `result_type` bleibt aus Gründen der Abwärtskompatibilität verfügbar.

## Parameter Liste

`result`

  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, so wird jeweils die nächste Zeile geholt.

`result_type`

  Ist veraltet und wird ignoriert. Der Standardwert ist `PGSQL_ASSOC`.

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

## Siehe auch

pg_query()
pg_fetch_array()
pg_fetch_assoc()
pg_fetch_row()
pg_fetch_result()

Zurück | Zum Anfang | Weiter
pg_fetch_assoc | Nach oben | pg_fetch_result