pg_fetch_array

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

pg_fetch_array — Повертає рядок результату у вигляді масиву

Опис

pg_fetch_array(PgSql\Result $result, ?int $row = null, int $mode = PGSQL_BOTH): array|false

pg_fetch_array() повертає масив, що відповідає обраному рядку (запису).

pg_fetch_array() розширена версія функції pg_fetch_row(). Ця функція здатна зберегти дані не лише з цифровими індексами, а й з асоціативними (ім'я поля). За умовчанням зберігає і ті, й інші.

Зауваження: Ця функція встановлює NULL-поля значення **null**PHP.

pg_fetch_array() виконується трохи повільніше ніж pg_fetch_row()але значно простіше у використанні.

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

result

Екземпляр PgSql\Result, що повертається функціями pg_query() pg_query_params() або pg_execute()(среди прочего).

row

Номер рядка в результат для вибірки. Рядки пронумеровані з 0 за зростанням. Якщо параметр опущено або передано null буде вибрано наступний рядок.

mode

Необов'язковий параметр, керуючий тим, як індексується масив, що повертається (array). Параметр mode є константою і може приймати такі значення: PGSQL_ASSOC PGSQL_NUM і PGSQL_BOTHПри использованииPGSQL_NUM функція повертає масив із числовими індексами, при використанні PGSQL_ASSOC вона поверне лише асоціативні індекси, а PGSQL_BOTH поверне як числові, і асоціативні індекси.

Значення, що повертаються

Масив (array) з числовими індексами (починаючи з 0), або асоціативними (на ім'я поля), або з обома типами індексів. Кожне значення у масиві (array) представлено як рядок (string). Значення NULL повертається як null

Функція повертає false, якщо row виходить за рамки кількості рядків у вибірці, чи відсутності рядків, чи у разі будь-якої іншої помилки. Вибірка з результату запиту, відмінного від SELECT, також поверне false

список змін

ВерсияОпис
8.1.0Параметрresult тепер чекає екземпляр PgSql\Result; раніше очікувався ресурс (resource

Приклади

Приклад #1 Приклад використання pg_fetch_array()****

Loading...

Дивіться також

  • pg_fetch_row() - Вибирає рядок результату запиту та поміщає дані до масиву
  • pg_fetch_object() - Вибирає рядок результату запиту та повертає дані у вигляді об'єкта
  • pg_fetch_result() - Повертає запис із результату запиту