1
0
mirror of https://github.com/postgres/postgres.git synced 2025-06-05 23:56:58 +03:00

Doc: document libpq's restriction to INT_MAX rows in a PGresult.

As long as PQntuples, PQgetvalue, etc, use "int" for row numbers, we're
pretty much stuck with this limitation.  The documentation formerly stated
that the result of PQntuples "might overflow on 32-bit operating systems",
which is just nonsense: that's not where the overflow would happen, and
if you did reach an overflow it would not be on a 32-bit machine, because
you'd have OOM'd long since.

Discussion: https://postgr.es/m/CA+FnnTxyLWyjY1goewmJNxC==HQCCF4fKkoCTa9qR36oRAHDPw@mail.gmail.com
This commit is contained in:
Tom Lane 2017-08-29 15:38:05 -04:00
parent dfd1042c6a
commit c7e990bb0f

View File

@ -2999,9 +2999,10 @@ void PQclear(PGresult *res);
<listitem>
<para>
Returns the number of rows (tuples) in the query result. Because
it returns an integer result, large result sets might overflow the
return value on 32-bit operating systems.
Returns the number of rows (tuples) in the query result.
(Note that <structname>PGresult</> objects are limited to no more
than <literal>INT_MAX</> rows, so an <type>int</> result is
sufficient.)
<synopsis>
int PQntuples(const PGresult *res);