array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.pg-fetch-array.php', 1 => 'pg_fetch_array', ), 'up' => array ( 0 => 'ref.pgsql.php', 1 => 'Функции PostgreSQL', ), 'prev' => array ( 0 => 'function.pg-fetch-all.php', 1 => 'pg_fetch_all', ), 'next' => array ( 0 => 'function.pg-fetch-assoc.php', 1 => 'pg_fetch_assoc', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/pgsql/functions/pg-fetch-array.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
pg_fetch_array — Возвращает строку результата в виде массива
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
Номер строки в result для выборки. Строки пронумерованы с 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()
<?php
$conn = pg_pconnect("dbname=publisher");
if (!$conn) {
echo "Произошла ошибка.\n";
exit;
}
$result = pg_query($conn, "SELECT author, email FROM authors");
if (!$result) {
echo "Произошла ошибка.\n";
exit;
}
$arr = pg_fetch_array($result, 0, PGSQL_NUM);
echo $arr[0] . " <- Row 1 Author\n";
echo $arr[1] . " <- Row 1 E-mail\n";
// Параметр row необязателен,
// для передечи result_type вместо row можно передать NULL.
// Успешные вызовы pg_fetch_array вернут следующий ряд.
$arr = pg_fetch_array($result, NULL, PGSQL_ASSOC);
echo $arr["author"] . " <- Row 2 Author\n";
echo $arr["email"] . " <- Row 2 E-mail\n";
$arr = pg_fetch_array($result);
echo $arr["author"] . " <- Row 3 Author\n";
echo $arr[1] . " <- Row 3 E-mail\n";
?>