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)