| PostgreSQL 8.2.23 Documentation | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Chapter 29. libpq - C Library | Fast Forward | Next |
These functions may be used to interrogate the status of an existing database connection object.
Tip: libpq application programmers should be careful to maintain the PGconn abstraction. Use the accessor functions described below to get at the contents of PGconn. Reference to internal PGconn fields using libpq-int.h is not recommended because they are subject to change in the future.
The following functions return parameter values established at connection. These values are fixed for the life of the PGconn object.
PQdbReturns the database name of the connection.
char *PQdb(const PGconn *conn);
PQuserReturns the user name of the connection.
char *PQuser(const PGconn *conn);
PQpassReturns the password of the connection.
char *PQpass(const PGconn *conn);
PQhostReturns the server host name of the connection.
char *PQhost(const PGconn *conn);
PQportReturns the port of the connection.
char *PQport(const PGconn *conn);
PQttyReturns the debug TTY of the connection. (This is obsolete, since the server no longer pays attention to the TTY setting, but the function remains for backwards compatibility.)
char *PQtty(const PGconn *conn);
PQoptionsReturns the command-line options passed in the connection request.
char *PQoptions(const PGconn *conn);
The following functions return status data that can change as operations are executed on the PGconn object.
PQstatus