pg_fetch_array

(PHP 4, PHP 5)

pg_fetch_arrayВозвращает строку результата в виде массива

Описание

array pg_fetch_array ( resource $result [, int $row [, int $result_type = PGSQL_BOTH ]] )

pg_fetch_array() возвращает массив, соответствующий выбранной строке (записи).

pg_fetch_array() расширенная версия функции pg_fetch_row(). Эта функция способна сохранить данные не только с цифровыми индексами, но и с ассоциативными (имя поля). По умолчанию хранит и те и другие.

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

pg_fetch_array() выполняется незначительно медленнее чем pg_fetch_row(), но значительно проще в использовании.

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

result

Ресурс результата запроса PostgreSQL, возвращенный функцией pg_query(), pg_query_params() или pg_execute() (и прочих).

row

Номер строки в result для выборки. Строки пронумерованы с 0 по возрастанию. Если параметр опущен или передан NULL будет выбрана следующая строка.

result_type

Необязательный параметр для управления типом индексации возвращаемого массива (array). Параметр result_type обязателен и может принимать следующие значения: PGSQL_ASSOC, PGSQL_NUM и PGSQL_BOTH. При указании PGSQL_NUM, pg_fetch_array() вернет массив с цифровыми индексами, в случае PGSQL_ASSOC вернет только ассоциативные индексы, а в случае PGSQL_BOTH (используется по умолчанию) -- цифровые и ассоциативные индексы.

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

Массив (array) с цифровыми индексами (начиная с 0), либо ассоциативнми (по имени поля), либо с обеими типами индексов. Каждое значение в массиве (array) представлено как строка (string). Значение NULL возвращается как NULL.

Функция возвращает FALSE если row выходит за рамки количества строк в выборке, или отсутствия строк, или в случае любой другой ошибки.

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

Версия Описание
4.1.0 Параметр row стал необязательным.

Примеры

Пример #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($result0PGSQL_NUM);
echo 
$arr[0] . " <- Row 1 Author\n";
echo 
$arr[1] . " <- Row 1 E-mail\n";

// С версии PHP 4.1.0 параметр row стал опциональным, 
// для передечи result_type вместо row можно передать NULL.
// Успешные вызовы pg_fetch_array вернут следующий ряд.

$arr pg_fetch_array($resultNULLPGSQL_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";

?>

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

  • pg_fetch_row() - Выбирает строку результата запроса и помещает данные в массив
  • pg_fetch_object() - Выбирает строку результата запроса и возвращает данные в виде объекта
  • pg_fetch_result() - Возвращает запись из результата запроса

Коментарии

PGSQL_BOTH is the default, meaning your array size will be doubled. 
If you specify this field (result type), include no quotes around it or you won't get any data, not even an error. 
Here's my wrapper function:
function SQL_fetch_array($result_ndx, $row, $result_type=PGSQL_ASSOC) { 
   return pg_fetch_array($result_ndx, $row, $result_type);
2001-01-02 23:14:22
http://php5.kiev.ua/manual/ru/function.pg-fetch-array.html
In addition to returning "false if there are no more rows", pg_fetch_array will also trigger an E_WARNING.  You can temporarily turn that error reporting level off and suck out all your data like so:

<?php
$errRptLvl 
error_reporting(); 
error_reporting($errRptLvl & ~(E_WARNING));
       
list(
$i,$j)=array(0,0); 
while (
$selection[$i++] = $this->fetchArray($j++)); // (fetchArray is a pg_fetch_array wrapper.)
error_reporting($errRptLvl); // Restore error reporting level.
unset($selection[$i-1]); // Delete the last, empty row.
return $selection;
?>
2001-03-06 12:30:58
http://php5.kiev.ua/manual/ru/function.pg-fetch-array.html
The column names if you use PGSQL_ASSOC or PGSQL_BOTH are always in lowercase, no matter what the name is in the database or in the query.
2001-03-27 19:52:36
http://php5.kiev.ua/manual/ru/function.pg-fetch-array.html
Just remember when you 'or die' to close your table(s) or you may get a confused look from non-internet explorer users.
2001-07-23 00:50:49
http://php5.kiev.ua/manual/ru/function.pg-fetch-array.html
Автор:
Please remember that if you have for example a table Customers with "cust_ID", "name" and "address" and another table Users with "u_ID","name" and "other" and then you SELECT WHERE cust_ID=u_ID then you'll get in the result array ONLY ONE "name" field, precisely the last one resulted from the select!!!
2001-09-28 14:15:57
http://php5.kiev.ua/manual/ru/function.pg-fetch-array.html
As of PHP 4.1.0, you can now use code such as the following to iterate through a result set:

$conn = pg_connect("host=localhost dbname=whatever");
$result = pg_exec($conn, "select * from table");
while ($row = pg_fetch_array($result))
{
     echo "data: ".$row["data"];
}

Can be a nice little time saver, PHP with MySQL has supported this for a while but I'm glad to see it extended to PostgreSQL...
2001-12-13 06:38:01
http://php5.kiev.ua/manual/ru/function.pg-fetch-array.html
(Timesaver) Be aware of the fact that keys in array returned by this function are (well, at least as of 4.2.3) of the same case as SQL column names (e.g. if your column name is ID then key name is also ID, not id or Id), and the keys in associative array are CASE SENSITIVE!!! So don't be surprised if you get unexpected results. Double check SQL column names and the key names.
2003-06-17 12:45:47
http://php5.kiev.ua/manual/ru/function.pg-fetch-array.html
Just because it is not really clear how to specify the result type, I poste this message.

I wrote a wrapper function which looks like this:

<?php
   
function db_fetch_array ($result$row NULL$result_type PGSQL_ASSOC)
    {
       
$return = @pg_fetch_array ($result$row$result_type);
        return 
$return;
    }
?>

I think this way it is quite comfortable to get the arrays you want.
2003-09-14 21:55:44
http://php5.kiev.ua/manual/ru/function.pg-fetch-array.html
Автор:
In response to eth0's comment below about SELECT'ing from two tables where the tables have columns with the same names, you can get around this problem like this:

"SELECT table1.foo AS foo1, table2.foo AS foo2 FROM table1, table2"

In the associative array returned, the keys will be "foo1" and "foo2".
2005-02-02 15:59:43
http://php5.kiev.ua/manual/ru/function.pg-fetch-array.html
Автор:
I found this out through help from the mailing lists.  If you need to reset the internal counter, use the pg_result_seek, similar to:

pg_result_seek($result, 0)

...plagiarized from the comment on the function's doc page.
2005-02-22 11:52:22
http://php5.kiev.ua/manual/ru/function.pg-fetch-array.html
Автор:
Hopefully most people realize this on their own, but the examples below where people tried to get creative with getting numerical or associative (not both) keys in the result are rather pointless. See the pg_fetch_assoc() and pg_fetch_row() for the built in functions that do this automatically. It's generally a better idea to use one of these other functions unless you *need* to access fields by both collumn name *and* index.
2005-05-13 17:21:07
http://php5.kiev.ua/manual/ru/function.pg-fetch-array.html
Note that when using PGSQL_BOTH, numerically and associatively indexed fields are separate variables and treated as such:

<?php
$res 
pg_query("Select 'foo' as bar");

$data pg_fetch_array($res0PGSQL_BOTH);

var_dump($data);
// Array(2)
// {
//   [0] => string(3) "foo"
//   ["bar"] => string(3) "foo"
// }

// This won't affect $data['bar']
$data[0] = 'bar';

var_dump($data);
// Array(2)
// {
//   [0] => string(3) "bar"
//   ["bar"] => string(3) "foo"
// }
?>

If you want to have reference binding between your numeric and associative indexes, you'll have to establish that yourself:

<?php

$result 
pg_query("Select 'foo' as bar");

$data pg_fetch_row($result);

// Establish references between column name/number
$from $data;
foreach(
$from as $cx => $value)
{
   
$key pg_field_name($result$cx);
    if (
is_string($key)) $data[$key] =& $data[$cx];
}

var_dump($data);
// Array(2)
// {
//   [0] => &string(3) "foo"
//   ["bar"] => &string(3) "foo"
// }
// Note the reference binding between $data[0] and $data['bar']

$data[0] = 'baz';

var_dump($data);
// Array(2)
// {
//   [0] => &string(3) "baz"
//   ["bar"] => &string(3) "baz"
// }

?>
2009-08-23 16:53:26
http://php5.kiev.ua/manual/ru/function.pg-fetch-array.html

    Поддержать сайт на родительском проекте КГБ