(PHP 4, PHP 5, PHP 7, PHP 8)
pg_fetch_row — Get a row as an enumerated array
pg_fetch_row() fetches one row of data from
the result associated with the specified result instance.
Note: This function sets NULL fields to the PHP
nullvalue.
resultAn PgSql\Result instance, 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 or null, the next row is fetched.
mode
An optional parameter that controls how the returned array is indexed.
mode is a constant and can take the following values:
PGSQL_ASSOC, PGSQL_NUM and PGSQL_BOTH.
Using PGSQL_NUM, the function will return an array with numerical indices,
using PGSQL_ASSOC it will return only associative indices
while PGSQL_BOTH will return both numerical and associative indices.
An array, indexed from 0 upwards, with each value
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.
| Version | Description |
|---|---|
| 8.1.0 |
The result parameter expects an PgSql\Result
instance now; previously, a resource was expected.
|
Example #1 pg_fetch_row() example
<?php
$conn = pg_pconnect("dbname=publisher");
if (!$conn) {
echo "An error occurred.\n";
exit;
}
$result = pg_query($conn, "SELECT author, email FROM authors");
if (!$result) {
echo "An error occurred.\n";
exit;
}
while ($row = pg_fetch_row($result)) {
echo "Author: $row[0] E-mail: $row[1]";
echo "<br />\n";
}
?>
I wondered whether array values of PostgreSQL are converted to PHP arrays by this functions. This is not the case, they are stored in the returned array as a string in the form "{value1 delimiter value2 delimiter value3}" (See http://www.postgresql.org/docs/8.0/interactive/arrays.html#AEN5389).Note, that when you retrieve some PG boolean value, you get 't' or 'f' characters which are not compatible with PHP bool.pg_fetch_row is faster than pg_fetch_assoc when doing a query with * as the select parameter. Otherwise, with declared columns, the two are similar in speed.Note that the internal row counter is incremented BEFORE the row is retrieved. This causes an off by one error if you try to do:
pg_result_seek($resid,0);
pg_fetch_row($resid);
you will get back the SECOND result not the FIRST.a way to do this with 2 loops to insert data into a table...
$num = pg_numrows($result);
$col_num = pg_numfields($result);
for ($i=0; $i<$num; $i++) {
$line = pg_fetch_array($result, $i, PGSQL_ASSOC);
print "\t<tr bgcolor=#dddddd>\n";
for ($j=0; $j<$col_num; $j++){
list($col_name, $col_value) =each($line);
print "\t\t<TD ALIGN=RIGHT><FONT SIZE=1 FACE='Geneva'>$col_value</FONT></TD>\n";
}
echo "<br>";
}