MySQL :: MySQL 8.4 C API Developer Guide :: 5.4.16 mysql_error() (original) (raw)

5.4.16 mysql_error()

const char *
mysql_error(MYSQL *mysql)

Description

For the connection specified by mysql,mysql_error() returns a null-terminated string containing the error message for the most recently invoked API function that failed. If a function did not fail, the return value ofmysql_error() may be the previous error or an empty string to indicate no error.

A rule of thumb is that all functions that have to ask the server for information resetmysql_error() if they succeed.

For functions that resetmysql_error(), either of these two tests can be used to check for an error:

if(*mysql_error(&mysql))
{
  // an error occurred
}

if(mysql_error(&mysql)[0])
{
  // an error occurred
}

The language of the client error messages may be changed by recompiling the MySQL client library. You can choose error messages in several different languages. SeeSetting the Error Message Language.

Return Values

A null-terminated character string that describes the error. An empty string if no error occurred.