27.7.6 C API 函数说明
本节介绍除用于准备语句或复制流接口的 C API 函数以外的 C API 函数。有关这些信息,请参阅第 27.7.10 节“ C API 准备的语句功能描述”和C API 二进制日志功能说明。
在此处的描述中,参数或返回值NULL
在 C 编程语言的意义上 table 示NULL
,而不是 MySQL NULL
值。
返回值的函数通常返回指针或整数。除非另有说明,否则返回指针的函数将返回非NULL
值指示成功,而返回NULL
值指示错误,而返回整数的函数将返回零以指示成功或返回非零以指示错误。请注意,“非零”就是这样。除非功能说明另有说明,否则请勿针对零以外的值进行测试:
if (result) /* correct */
... error ...
if (result < 0) /* incorrect */
... error ...
if (result == -1) /* incorrect */
... error ...
当函数返回错误时,函数描述的** Errors 子节列出了可能的错误类型。您可以通过致电mysql_errno()来找出其中发生的情况。可以通过调用mysql_error()获得错误的字符串 table 示形式。