PostgreSQL
PHP Manual

pg_fetch_object

(PHP 4, PHP 5)

pg_fetch_object — Выбирает строку результата запроса и возвращает данные в виде объекта

Описание

object 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 ]]] )

pg_fetch_object() возвращает объект, свойства которого соответствуют именам полей выборки. Также функция может создать экземпляр конкретного класса и передать параметры его конструктору.

Замечание: Эта функция устанавливает NULL-поля в значение NULL PHP.

По скорости функция идентична pg_fetch_array() и немного медленней pg_fetch_row() (разница незначительна).

Список параметров

result

Ресурс результата запроса PostgreSQL, возвращаемый функциями pg_query(), pg_query_params() или pg_execute() (в числе прочих).

row

Номер выбираемой из результата запроса строки. Нумерация начинается с нуля. Если аргумент опущен или равен NULL, берется следующая по очереди строка.

result_type

Устарел и не используется.

class_name

Имя класса создаваемого и возвращаемого объекта. Если не задано, функция создаст экземпляр класса stdClass.

params

Необязательный аргумент. Массив параметров для передачи в конструктор создаваемого объекта.

Возвращаемые значения

object, имена и значения свойств которого соответствуют именам и значениям полей результата запроса. Значения NULL базы данных преобразуются в PHP NULL.

FALSE, когда row превышает число строк в результате запроса, когда строк в результате не осталось, и при прочих ошибках.

Список изменений

Версия Описание
5.0.0 Добавлены аргументы class_name и params. Устаревший вариант с result_type оставлен для обратной совместимости.
4.3.0 Значение по-умолчанию аргумента result_type изменено с PGSQL_BOTH на PGSQL_ASSOC с тех пор как перестали использоваться численно индексированные массивы.
4.1.0 Аргумент row стал необязательным.

Примеры

Пример #1 Пример использования pg_fetch_object()

<?php 

$database = "store";

$db_conn = pg_connect("host=localhost port=5432 dbname=$database");
if (!$db_conn) {
  echo "Невозможно соединиться с postgres базой $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