(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

pg_num_rowsВозвращает количество строк в выборке


pg_num_rows(PgSql\Result $result): int

pg_num_rows() возвращает количество строк в экземпляре PgSql\Result.


Ранее функция называлась pg_numrows().

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


Экземпляр класса PgSql\Result, который возвращают функции pg_query(), pg_query_params() или pg_execute() (среди прочего).

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

Количество строк в выборке. В случае возникновения ошибки возвращает -1.

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

Версия Описание
8.1.0 Параметр result теперь ожидает экземпляр класса PgSql\Result; раньше параметр ждал ресурс (resource).


Пример #1 Пример использования pg_num_rows()

= pg_query($conn, "SELECT 1");

$rows = pg_num_rows($result);

"Возвращено строк: " . $rows . ".\n";

Результат выполнения приведённого примера:

Возвращено строк: 1.

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

  • pg_num_fields() - Возвращает количество полей в выборке
  • pg_affected_rows() - Возвращает количество затронутых запросом записей (кортежей)

add a note

User Contributed Notes 3 notes

strata_ranger at hotmail dot com
15 years ago
As mentioned, if you are performing an INSERT/UPDATE or DELETE query and want to know the # of rows affected, you should use pg_affected_rows() instead of pg_num_rows().

However, you can also exploit postgres's RETURNING clause in your query to auto-select columns from the affected rows. This has the advantage of being able to tell not only how many rows a query affects, but exactly which rows those were, especially if you return a primary-key column.

For example:


// Example query. Let's say that this updates five rows in the source table.
$res = pg_query("Update foo set bar = 'new data' where = 'old data' ");
pg_num_rows($res); // 0
pg_affected_rows($res); // 5
pg_fetch_all($res); // FALSE

// Same query, with a RETURNING clause.
$res = pg_query("Update foo set bar = 'new data' where = 'old data' RETURNING foo.pkey");
pg_num_rows($res); // 5
pg_affected_rows($res); // 5
pg_fetch_all($res); // Multidimensional array corresponding to our affected rows & returned columns
francisco at natserv dot com
16 years ago
Not sure why this documentation doesn't have the following note:
Note: Use pg_affected_rows() to get number of rows affected by INSERT, UPDATE and DELETE query.

Found on other resources. Adding here in case someone else is looking for the info.
15 years ago
About preceding note, you shouldn't use pg_num_rows() for this.
You should have instead a look at pg_affected_rows().
To Top