Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
PQgeterror(3)		       libpqtypes Manual		 PQgeterror(3)

NAME
       PQgeterror,  PQseterror,	PQgetErrorField	- libpqtypes error system man-
       agement 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 set-
       ting 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)

libpqtypes			     2011			 PQgeterror(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | EXAMPLES | AUTHOR | REPORTING BUGS | COPYRIGHT | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=PQgeterror&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help