diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml
index 72c9384..5417df1 100644
--- a/doc/src/sgml/libpq.sgml
+++ b/doc/src/sgml/libpq.sgml
@@ -7233,6 +7233,199 @@ int PQisthreadsafe();
+
+ Alternative row processor
+
+
+ PGresult
+ PGconn
+
+
+
+ As the standard usage, users can get the result of command
+ execution from PGresult aquired
+ with PGgetResult
+ from PGConn. While the memory areas for
+ the PGresult are allocated with malloc() internally within calls of
+ command execution functions such as PQexec
+ and PQgetResult. If you have difficulties to
+ handle the result records in the form of PGresult, you can instruct
+ PGconn to pass every row to your own row processor instead of
+ storing into PGresult.
+
+
+
+
+
+ PQregisterRowProcessor
+
+ PQregisterRowProcessor
+
+
+
+
+
+ Sets a callback function to process each row.
+
+void PQregisterRowProcessor(PGconn *conn,
+ RowProcessor func,
+ void *param);
+
+
+
+
+
+
+ conn
+
+
+ The connection object to set the storage handler
+ function. PGresult created from this connection calls this
+ function to process each row.
+
+
+
+
+ func
+
+
+ Storage handler function to set. NULL means to use the
+ default processor.
+
+
+
+
+ param
+
+
+ A pointer to contextual parameter passed
+ to func.
+
+
+
+
+
+
+
+
+
+
+
+
+ RowProcessor
+
+ RowProcessor
+
+
+
+
+
+ The type for the row processor callback function.
+
+bool (*RowProcessor)(PGresult *res,
+ void *param,
+ PGrowValue *columns);
+
+typedef struct
+{
+ int len; /* length in bytes of the value */
+ char *value; /* actual value, without null termination */
+} PGrowValue;
+
+
+
+
+
+ This function must return TRUE for success, and FALSE for
+ failure. On failure this function should set the error message
+ with PGsetRowProcessorErrMes if the cause
+ is other than out of memory. This funcion must not throw any
+ exception.
+
+
+
+
+ res
+
+
+ A pointer to the PGresult object.
+
+
+
+
+
+ param
+
+
+ A pointer to contextual parameter which is registered
+ by PQregisterRowProcessor.
+
+
+
+
+
+ columns
+
+
+ Column values of the row to process.
+
+
+
+
+
+
+
+
+
+
+
+ PQsetRowProcessorErrMes
+
+ PQsetRowProcessorErrMes
+
+
+
+
+ Set the message for the error occurred
+ in RowProcessor. If this message is not set, the
+ caller assumes the error to be out of memory.
+
+void PQsetRowProcessorErrMes(PGresult *res, char *mes)
+
+
+
+
+
+ res
+
+
+ A pointer to the PGresult object
+ passed to RowProcessor.
+
+
+
+
+ mes
+
+
+ Error message. This will be copied internally so there is
+ no need to care of the scope.
+
+
+ If res already has a message previously
+ set, it will be overritten. Set NULL to cancel the the costom
+ message.
+
+
+
+
+
+
+
+
+
+
+
Building <application>libpq</application> Programs