pg_fetch_object

(PHP 4, PHP 5, PHP 7, PHP 8)

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

Описание

pg_fetch_object(
    PgSql\Result $result,
    ?int $row = null,
    string $class = "stdClass",
    array $constructor_args = []
): object|false

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

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

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

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

result: Экземпляр PgSql\Result, возвращаемый функциями pg_query(), pg_query_params() или pg_execute() (среди прочего).
row: Номер выбираемой из результата запроса строки. Нумерация начинается с нуля. Если аргумент опущен или равен null, берётся следующая по очереди строка.
class: Имя класса создаваемого и возвращаемого объекта. Если не задано, функция создаст экземпляр класса stdClass.
constructor_args: Необязательный аргумент. Массив (array) параметров для передачи в конструктор создаваемого объекта (class).

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

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

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

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

Версия	Описание
8.1.0	Параметр `result` теперь ожидает экземпляр PgSql\Result; ранее ожидался ресурс (resource).

Примеры

Пример #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);

?>

Смотрите также

pg_query() - Выполняет запрос
pg_fetch_array() - Возвращает строку результата в виде массива
pg_fetch_assoc() - Выбирает строку результата запроса и помещает данные в ассоциативный массив
pg_fetch_row() - Выбирает строку результата запроса и помещает данные в массив
pg_fetch_result() - Возвращает запись из результата запроса