PostgreSQL Функции
PHP Manual

pg_fetch_object

(PHP 4, PHP 5)

pg_fetch_objectИзважда ред под формата на обект

Описание

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() връща обект със свойства, които съответстват на имената на полетата от извадения ред. По избор тя може да инстанциира обект от специфичен клас и да предаде параметрите на конструктора на този клас.

Забележка: Тази функция установява NULL полетата със стойността null; в PHP.

По скорост функцията е идентична на pg_fetch_array() и почти толкова бърза колкото pg_fetch_row() (разликата е незначителна).

Параметри

result

Резултатен ресурс от заявка в PostgreSQL, върнат от pg_query(), pg_query_params(), pg_execute() и др.

row

Номер на реда, който да бъде извлечен от резултата. Редовете се номерират започвайки от 0 нагоре. Ако се пропусне, ще бъде извлечен следващия ред.

result_type

Не се взима под внимание и е непрепоръчителен. По подразбиране е PGSQL_ASSOC.

class_name

Име на класа, който да бъде инстанцииран, чиито свойства да бъдат установени и който да бъде върнат. Ако такъв не е указан, ще бъде върнат обект от тип stdClass.

params

Масив по избор, който да бъде предаден на конструктора на class_name .

Връщани стойности

Обект с по едно свойство за всяко име на поле от резултата. Стойностите NULL от базата от данни се връщат като NULL.

Връща FALSE в случаите, когато row надвишава броя редове в множеството, когато няма повече редове, или при каква да е друга грешка.

Дневник на промените

Версия Описание
5.0.0 Бяха добавени class_name и params . Старият формат с result_type все още съществува, от съображения за обратна съвместимост.
4.3.0 Стойността по подразбиране за result_type се промени от PGSQL_BOTH на PGSQL_ASSOC, тъй като числовият индекс беше невалиден.
4.1.0 Параметърът row стана незадължителен.

Примери

Example #1 Пример за pg_fetch_object()

<?php 

$database 
"store";

$db_conn pg_connect("host=localhost port=5432 dbname=$database");
if (!
$db_conn) {
  echo 
"Неуспешно свързване с $database\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);

?>

Вж. също


PostgreSQL Функции
PHP Manual