pg_fetch_assoc
pg_fetch_result
PostgreSQL Funktionen
PHP Manual

# pg_fetch_object

(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 und die Parameter `params` an den Konstruktor dieser Klasse übergeben.

> 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`

  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.

### ChangeLog

Version | Beschreibung
--- | ---
5.0.0 | Die Parameter `class_name` und `params` wurden hinzugefügt. Die herkömmliche Form mit `result_type` bleibt aus Gründen der Abwärtskompatibilität verfügbar.
4.3.0 | Die Standardeinstellung von `result_type` wurde von `PGSQL_BOTH` auf `PGSQL_ASSOC` geändert, da ein numerischer Index bei Objekten unzulässig war.
4.1.0 | Der Parameter `row` wurde optional.

### 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()

pg_fetch_assoc
pg_fetch_result
PostgreSQL Funktionen
PHP Manual