PQgeterror(3)

PQgeterror3

Libpqtypes error system management functions

Usage

#include <libpqtypes.h>

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

Overview

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.

Releases

Unchanged in 5 releases since Debian 8 (Jessie).

  1. 8–12

Author

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

Reporting bugs

Report bugs to <[email protected]>.

From libpqtypes-dev 1.5.1-9 in Debian 12 (Bookworm). Parsed by carta from the page's man source.