PHP: pg_fetch_array - Manual

downloads | documentation | faq | getting help | mailing lists | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

pg_fetch_assoc pg_fetch_all

Last updated: Sat, 27 Jan 2007

view this page in

# pg_fetch_array

(PHP 3 >= 3.0.1, PHP 4, PHP 5)

pg_fetch_array -- Fetch a row as an array

## Описание

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

pg_fetch_array() returns an array that corresponds to the fetched row (record).

pg_fetch_array() is an extended version of pg_fetch_row(). In addition to storing the data in the numeric indices (field number) to the result array, it can also store the data using associative indices (field name). It stores both indicies by default.

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

pg_fetch_array() is NOT significantly slower than using pg_fetch_row(), and is significantly easier to use.

> Замечание: `row` became optional in PHP 4.1.0.

> Замечание: `result_type` was added in PHP 4.0.0.

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

`result`

  PostgreSQL query result resource, returned by pg_query(), pg_query_params() or pg_execute() (among others).

`row`

  Row number in result to fetch. Rows are numbered from 0 upwards. If omitted, next row is fetched.

`result_type`

  An optional parameter that controls how the returned array is indexed. `result_type` is a constant and can take the following values: `PGSQL_ASSOC`, `PGSQL_NUM` and `PGSQL_BOTH`. Using `PGSQL_NUM`, pg_fetch_array() will return an array with numerical indices, using `PGSQL_ASSOC` it will return only associative indices while `PGSQL_BOTH`, the default, will return both numerical and associative indices.

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

An array indexed numerically (beginning with 0) or associatively (indexed by field name), or both. Each value in the array is represented as a string. Database `NULL` values are returned as `NULL`.

`FALSE` is returned if `row` exceeds the number of rows in the set, there are no more rows, or on any other error.

## Примеры

Пример 1. pg_fetch_array() example

`<?php
$conn = pg_pconnect("dbname=publisher");
if (!$conn) {
echo "An error occured.\n";
exit;
}
$result = pg_query($conn, "SELECT author, email FROM authors");
if (!$result) {
echo "An error occured.\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";
// As of PHP 4.1.0, the row parameter is optional; NULL can be passed instead,
// to pass a result_type. Successive calls to pg_fetch_array will return the
// next row.
$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";
?>`

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

pg_fetch_row()
pg_fetch_object()
pg_fetch_result()

add a note User Contributed Notes
pg_fetch_array
anonymous
13-May-2005 02:21
`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.`
Dave O
22-Feb-2005 09:52
`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.`
devnull
02-Feb-2005 01:59
`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".`
enyo at www.red-link.com
14-Sep-2003 06:55
`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.`
akm at e-nterart dot pl
17-Jun-2003 09:45
`(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.`
jesse at sokieserv dot dhs dot org
13-Dec-2001 04:38
`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...`
eth0 at fins
28-Sep-2001 11:15
`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!!!`
elliot at nospam dot rightnowtech dot com
22-Jul-2001 09:50
`Just remember when you 'or die' to close your table(s) or you may get a confused look from non-internet explorer users.`
gmoros at altavista dot com
22-Jun-2001 08:06
`If the connection with the database fails, you can add "or die" + your message to show, with @pg_connect don�t display error messages.
$conn = @pg_connect("dbname=marliese port=5432") or die ("Can�t connect to database);`
buyaka AT ragingbull DOT com
01-Apr-2001 11:23
`An easier way to loop through the result with pg_fetch_array() and turn off error reporting is like so:
for($i=0;
$row = @pg_fetch_array($result,$i); $i++)
{
echo $row["field_name"];
}
The '@' before the function name turns off error reporting.`
mkb at ele dot uri dot edu
27-Mar-2001 04:52
`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.`
gherson at snet dot net
06-Mar-2001 10:30
`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:
$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;`
sgarib at vrweb dot cl
30-Jan-2001 02:07
`when you retrive a boolean value from postgreSQL the result is "t" and "f" (as a string) instead of 1 and 0 so you can't ask somenthing like :
if (!(rstemp["booleanvalue"]))
{ do_ somenthing();}`
gherson at snet dot net
02-Jan-2001 09:14
`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);`
add a note
pg_fetch_assoc pg_fetch_all

Last updated: Sat, 27 Jan 2007
show source | credits | stats | sitemap | contact | advertising | mirror sites
Copyright © 2001-2007 The PHP Group
All rights reserved.
This mirror generously provided by: Yahoo! Inc.
Last updated: Sat Mar 10 10:36:09 2007 PST