efun: db_insert_id

OPTIONAL:

SYNOPSIS:

        int db_insert_id (int handle)

DESCRIPTION:

        After inserting a line into a table with an AUTO_INCREMENT field,
        this efun can be used to return the (new) value of the AUTO_INCREMENT
        field.

        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_insert_id").

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_connect(E), db_error(E), db_exec(E), db_fetch(E), db_handles(E),
	mysql(C), privilege_violation(M)