(PHP 4, PHP 5)
pg_fetch_object — Изважда ред под формата на обект
pg_fetch_object() връща обект със свойства, които съответстват на имената на полетата от извадения ред. По избор тя може да инстанциира обект от специфичен клас и да предаде параметрите на конструктора на този клас.
Забележка: Тази функция установява NULL полетата със стойността null; в PHP.
По скорост функцията е идентична на pg_fetch_array() и почти толкова бърза колкото pg_fetch_row() (разликата е незначителна).
Резултатен ресурс от заявка в PostgreSQL, върнат от pg_query(), pg_query_params(), pg_execute() и др.
Номер на реда, който да бъде извлечен от резултата. Редовете се номерират започвайки от 0 нагоре. Ако се пропусне, ще бъде извлечен следващия ред.
Не се взима под внимание и е непрепоръчителен. По подразбиране е PGSQL_ASSOC.
Име на класа, който да бъде инстанцииран, чиито свойства да бъдат установени и който да бъде върнат. Ако такъв не е указан, ще бъде върнат обект от тип stdClass.
Масив по избор, който да бъде предаден на конструктора на 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);
?>