mirrors/postgres
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Document that PQexec() can handle a NULL res pointer just fine.

Browse Source 
Backpatch to 9.1.

Mark Hills
This commit is contained in:
Bruce Momjian 2011-11-10 13:00:44 -05:00
parent 2e02280726
commit d5873b6359
1 changed files with 5 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
doc/src/sgml/libpq.sgml
View File

@ -62,7 +62,7 @@
return a non-null object pointer, unless perhaps there is too return a non-null object pointer, unless perhaps there is too
little memory even to allocate the <structname>PGconn</> object. little memory even to allocate the <structname>PGconn</> object.
The <function>PQstatus</> function should be called to check The <function>PQstatus</> function should be called to check
whether a connection was successfully made before queries are sent the return value for a successful connection before queries are sent
via the connection object. via the connection object.
<warning> <warning>
@ -1754,8 +1754,10 @@ PGresult *PQexec(PGconn *conn, const char *command);
Returns a <structname>PGresult</structname> pointer or possibly a null Returns a <structname>PGresult</structname> pointer or possibly a null
pointer. A non-null pointer will generally be returned except in pointer. A non-null pointer will generally be returned except in
out-of-memory conditions or serious errors such as inability to send out-of-memory conditions or serious errors such as inability to send
the command to the server. If a null pointer is returned, it should the command to the server. The <function>PQresultStatus</> function
be treated like a <symbol>PGRES_FATAL_ERROR</symbol> result. Use should be called to check the return value for any errors (including
the value of a null pointer, in which case it will return
<symbol>PGRES_FATAL_ERROR</symbol>). Use
<function>PQerrorMessage</function> to get more information about such <function>PQerrorMessage</function> to get more information about such
errors. errors.
</para> </para>