©
本文档使用 PHP中文网手册 发布
(PHP 4 >= 4.2.0, PHP 5)
pg_num_rows — 返回行的数目
$result
) pg_num_rows() 返回 PostgreSQL result
中的行的数目。result
参数是由 pg_query() 函数返回的查询结果资源号。如果出错则返回 -1。
Note:
用 pg_affected_rows() 函数获得被 INSERT,UPDATE 和 DELETE 命令影响到的行的数目。
Note:
本函数以前的名字为 pg_numrows()。
参见 pg_num_fields() 和 pg_affected_rows() 。
[#1] strata_ranger at hotmail dot com [2009-05-10 10:06:10]
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:
<?php
// Example query. Let's say that this updates five rows in the source table.
$res = pg_query("Update foo set bar = 'new data' where foo.bar = '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 foo.bar = '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
?>
[#2] ElDiablo [2008-10-06 07:09:58]
About preceding note, you shouldn't use pg_num_rows() for this.
You should have instead a look at pg_affected_rows().
[#3] francisco at natserv dot com [2008-01-07 08:26:27]
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.