pg_fetch_row

(PHP 4, PHP 5, PHP 7, PHP 8)

pg_fetch_row — Get a row as an enumerated array

Опис

pg_fetch_row(PgSql\Result $result, ?int $row = null, int $mode = PGSQL_NUM): array|false

pg_fetch_row() fetches one row of data from the result associated with the specified result instance.

Зауваження: Ця функція встановлює NULL-полям значення PHP null.

Параметри

result: Примірник PgSql\Result, якого повертає одна з функцій pg_query(), pg_query_params() або pg_execute() (серед інших).
row: Row number in result to fetch. Rows are numbered from 0 upwards. If omitted or null, the next row is fetched.
mode: Необов'язковий параметр, яким вказується спосіб індексування масиву (array). mode може мати значення однієї з констант: PGSQL_ASSOC, PGSQL_NUM або PGSQL_BOTH. Якщо задано PGSQL_NUM, то функція поверне масив з числовими індексами; якщо PGSQL_ASSOC, то з асоціативними індексами; якщо PGSQL_BOTH, то і з числовими, і з асоціативними індексами.

Значення, що повертаються

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.

Журнал змін

Версія	Опис
8.1.0	Тепер параметр `result` має бути примірником PgSql\Result. Раніше очікувався resource.

Приклади

Приклад #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";
}
 
?>

Прогляньте також

pg_query() - Execute a query
pg_fetch_array() - Fetch a row as an array
pg_fetch_object() - Fetch a row as an object
pg_fetch_result() - Returns values from a result instance

Improve This Page

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 5 notes

down

post at zeller-johannes dot de ¶

19 years ago


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).

down

pletiplot at seznam dot cz ¶

18 years ago


Note, that when you retrieve some PG boolean value, you get 't' or 'f' characters which are not compatible with PHP bool.

down

eddie at eddiemonge dot com ¶

14 years ago


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.

down

darw75 at swbell dot net ¶

23 years ago


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>";

  }

down

-1

Matthew Wheeler ¶

21 years ago


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.

＋add a note