MySQL :: MySQL 8.0 C API Developer Guide :: 7.4.5 mysql_real_query_nonblocking() (original) (raw)

7.4.5 mysql_real_query_nonblocking()

enum net_async_status
mysql_real_query_nonblocking(MYSQL *mysql,
                             const char *stmt_str,
                             unsigned long length)

Description

Note

mysql_real_query_nonblocking() is an asynchronous function. It is the counterpart of themysql_real_query() synchronous function, for use by applications that require asynchronous communication with the server. For general information about writing asynchronous C API applications, see Chapter 7, C API Asynchronous Interface.

mysql_real_query_nonblocking() is used similarly tomysql_real_query(). For details about the latter, seeSection 5.4.62, “mysql_real_query()”. The two functions differ as follows:

• mysql_real_query() returns an integer status indicator.
• mysql_real_query_nonblocking() returns an enum net_async_status status indicator.

mysql_real_query_nonblocking() was added in MySQL 8.0.16.

Return Values

Returns an enum net_async_status value. See the description inSection 7.2, “C API Asynchronous Interface Data Structures”. ANET_ASYNC_ERROR return status indicates an error.

Example

See Chapter 7, C API Asynchronous Interface.