27.7.10.27 mysql_stmt_sqlstate()

const char *mysql_stmt_sqlstate(MYSQL_STMT *stmt)

Description

对于stmt指定的语句,mysql_stmt_sqlstate()返回以空值结尾的字符串,其中包含最近调用的成功或失败的预准备语句 API 函数的 SQLSTATE 错误代码。错误代码由五个字符组成。 "00000"table 示“没有错误”。这些值由 ANSI SQL 和 ODBC 指定。有关可能值的列 table,请参见附录 B,错误消息和常见问题

并非所有 MySQL 错误都 Map 到 SQLSTATE 代码。值"HY000"(一般错误)用于未 Map 的错误。

如果失败的语句 API 函数是mysql_stmt_close(),则不要调用mysql_stmt_sqlstate()来获取错误信息,因为mysql_stmt_close()会使语句处理程序无效。请致电mysql_sqlstate()

Return Values

一个空终止的字符串,其中包含 SQLSTATE 错误代码。