NAME

       PQgeterror, PQseterror, PQgetErrorField - libpqtypes error system management functions

SYNOPSIS

       #include <libpqtypes.h>

       char *PQgeterror(void);
       void PQseterror(const char *format, ...);
       char *PQgetErrorField(int fieldcode);

DESCRIPTION

       The  libpqtypes  library  maintains  a  per-thread global error message.  The error message is managed by
       PQgeterror() and PQseterror().

       PQseterror() takes a regular printf compatible format string for setting the libpqtypes error message.

       PQgetErrorField() gets an error field from the last executed query.  The  error  field  is  only  set  by
       PQparamExec  and  PQparamExecPrepared.   When  using  libpq  functions  that return results, like PQexec,
       continue to use PQresultErrorField.

       To clear the libpqtypes error message, call PQseterror() with a  NULL  format  string:  PQseterror(NULL);
       This will also clear error fields.

RETURN VALUE

       PQgeterror() returns the last error message for the calling thread.  It will never return NULL.

       PQgetErrorField() returns the error field, referenced by fieldcode, for the last executed query.  NULL is
       returned if no value exists.

EXAMPLES

       None.

AUTHOR

       A contribution of eSilo, LLC. for the PostgreSQL Database Management System.  Written by  Andrew  Chernow
       and Merlin Moncure.

REPORTING BUGS

       Report bugs to <libpqtypes@esilo.com>.

COPYRIGHT

       Copyright (c) 2011 eSilo, LLC. All rights reserved.
       This  is  free  software;  see  the  source  for  copying conditions.  There is NO warranty; not even for
       MERCHANTABILITY or  FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO

       pqt-specs(3)