qdb_geterrmsg()

Return last error

Synopsis:

#include <qdb/qdb.h>

const char * qdb_geterrmsg(qdb_hdl_t *hdl);

Arguments:

hdl: A pointer to the database handle.

Library:

qdb

Description:

This function returns a pointer to a string containing an error message from the server for the most recent call to:

qdb_statement()
qdb_getresult()
qdb_getoption()
qdb_setoption()
qdb_busytimeout()
qdb_vacuum()
qdb_backup()
qdb_getdbsize()

You typically call this function after one of the above functions fails. If the error occurred within the SQL library, the returned string is an SQLite error message. If the error occurred in the QDB system, the returned string is a POSIX errno message.

Returns:

A pointer to string if there is an error message, or a pointer to an empty string if there is no error.

Classification:

QNX Neutrino

Safety:
Interrupt handler	No
Signal handler	No
Thread	Yes

See also:

qdb_backup(), qdb_getdbsize(), qdb_getoption(), qdb_getresult(), qdb_setoption(), qdb_statement(), qdb_vacuum(),