[Main page] [Overview]     /efun /pg_connect

---

OPTIONAL
SYNOPSIS
int pg_connect (string conn, string fun)
int pg_connect (string conn, string fun, string|object obj, mixed extra, ...)
int pg_connect (string conn, closure cl, mixed extra, ...)

DESCRIPTION
Open a database connection as directed by <conn>, and assign the
callback function <fun>/<cl> with the optional <extra> parameters
to it.

The object holding the callback function becomes the controlling
object; obiously it is an error to assign more than one connection
to the same controlling object.

The <conn> string is in the format accepted by Postgres'
PQconnectStart() API functions. Pass an empty string to use the
default options, or a string holding the '<key>=<value>' options
separated by whitespace.

The most useful options are:
dbname: The database name
user: The user name to connect as.
password: Password to be used.

Return 0 on success, and -1 on failure.

The function is available only if the driver is compiled with
PostgreSQL support. In that case, __PGSQL__ is defined.

The efun triggers a privilege violation ("pgsql", "pg_connect").

HISTORY
Added in 3.3.445.
LDMud 3.3.640 added the privilege violation.

SEE ALSO
pgsql(C), pg_query(E), pg_pending(E), pg_conv_string(E), pg_close(E),
privilege_violation(M)