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() - Повертає запис із результату запиту