(PHP 4, PHP 5)
pg_fetch_object — Pobiera wiersz jako obiekt
$wynik
[, int $wiersz
[, int $typ_wyniku = PGSQL_ASSOC
]] )$wynik
[, int $wiersz
[, string $nazwa_klasy
[, array $parametry
]]] )pg_fetch_object() zwraca obiekt którego atrybutami są nazwy pól pobranego wiersza. Może dodatkowo tworzyć pewien obiekt określonej klasy, oraz wstawić parametry do konstruktora tej klasy.
Informacja: Ta funkcja ustala wartość pól NULL na
NULL.
Pod względem szybkości funkcja ta jest identyczna jak pg_fetch_array(), i prawie tak szybka jak pg_fetch_row() (różnica jest znikoma).
wynik
Identyfikator wyniku zapytania PostgreSQL, zwrócony przez pg_query(), pg_query_params() lub pg_execute() (między innymi).
wiersz
Numer wiersza w wyniku do pobrania. Wiersze są numerowane od zera w górę. Jeśli jest pominięty
albo wynosi NULL, pobrany zostanie kolejny wiersz.
typ_wyniku
Pomijany i przestarzały.
nazwa_klasy
Nazwa klasy do wytworzenia, określenie zwracanych parametrów. Jeśli nie podano, zwrócony zostanie obiekt stdClass.
parametry
Opcjonalna tablica (ang. array) parametrów podawanych do konstruktora
obiektów klasy nazwa_klasy.
Obiekt (ang. object) z atrybutem dla każdej nazwy
kolumny w wyniku. Wartości NULL z bazy danych
są zwracane jako NULL.
FALSE jest zwracne, gdy parametr wiersz przekracza całkowitą
liczbę wierszy, gdy kolejny wiersz nie istnieje, lub w przypadku każdego innego błędu.
| Wersja | Opis |
|---|---|
| 5.0.0 |
Parametry nazwa_klasy oraz parametry
zostały dodane. Stara wersja z typ_wyniku
wciąż istnieje, w celu zachowania wstecznej kompatybilności.
|
| 4.3.0 |
Domyślną wartość parametru typ_wyniku zmieniono z
PGSQL_BOTH na PGSQL_ASSOC,
gdyż indeks numeryczny był niepoprawny.
|
| 4.1.0 |
Parametr wiersz stał się opcjonalnym.
|
Przykład #1 pg_fetch_object() - przykład
<?php
$baza = "magazyn";
$polaczenie = pg_connect("host=localhost port=5432 dbname=$baza");
if (!$polaczenie) {
echo "Błąd połączenia do bazy PostgreSQL $baza\n";
exit;
}
$zap = pg_query($polaczenie, "SELECT * FROM ksiazki ORDER BY autor");
while ($dane = pg_fetch_object($zap)) {
echo $dane->autor . " (";
echo $dane->rok . "): ";
echo $dane->tytul . "<br />";
}
pg_free_result($zap);
pg_close($polaczenie);
?>