efun: db_connect

OPTIONAL:

SYNOPSIS:

        int db_connect(string database)
        int db_connect(string database, string user)
        int db_connect(string database, string user, string password)

DESCRIPTION:

        Connect to the database <database> on the local mySQL-server.
        The return-value is the handle for this connection.
        If the database does not exist or the server is NOT started,
        a runtime-error is raised.

        If specified, the connection is made for <user> with <password>.

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

        The efun triggers a privilege violation ("mysql", "db_connect").

HISTORY:

        Added in 3.2.9 .
        LDMud 3.2.11 added the privilege violation.

SEE ALSO:

	
	db_affected_rows(E), db_conv_string(E), db_close(E), db_coldefs(E),
	db_exec(E), db_error(E), db_fetch(E), db_handles(E),
	db_insert_id(E), mysql(C), privilege_violation(M)