Documentation Home
MySQL 8.0 C API 开发者指南

5.4.62 mysql_real_query()

int
mysql_real_query(MYSQL *mysql,
                 const char *stmt_str,
                 unsigned long length)

描述

笔记

mysql_real_query()是一个同步函数。它的异步对应物是 mysql_real_query_nonblocking()，供需要与服务器进行异步通信的应用程序使用。请参阅 第 7 章，C API 异步接口。

mysql_real_query()执行 指向的 SQL 语句stmt_str，一个字符串length字节长。通常，字符串必须由单个 SQL 语句组成，不带终止分号 ( ;) 或 \g。如果启用了多语句执行，则该字符串可以包含多个以分号分隔的语句。请参阅 第 3.6.3 节，“多语句执行支持”。

mysql_query()不能用于包含二进制数据的语句；你必须 mysql_real_query()改用。（二进制数据可能包含\0字符，它mysql_query()被解释为语句字符串的结尾。）此外， mysql_real_query()它比mysql_query()不调用strlen()语句字符串更快。

要确定语句是否返回结果集，请调用 mysql_field_count()。参见 第 5.4.23 节，“mysql_field_count()”。

返回值

零成功。如果发生错误，则非零。

错误