7.4.6 mysql_store_result_nonblocking()

enum net_async_status
mysql_store_result_nonblocking(MYSQL *mysql,
                               MYSQL_RES **result)

Описание

Примечание

mysql_store_result_nonblocking() — это асинхронная функция. Она является аналогом синхронной функции mysql_store_result() и предназначена для использования в приложениях, требующих асинхронного взаимодействия с сервером. Для получения общей информации об написании асинхронных приложений на основе C API см. Главу 7, C API Асинхронный интерфейс.

mysql_store_result_nonblocking() используется аналогично mysql_store_result(). Подробнее об последней см. Раздел 5.4.84, “mysql_store_result()”. Эти функции отличаются следующим:

mysql_store_result() возвращает указатель на значение MYSQL_RESULT, содержащее результат набора данных, или NULL, если набора результатов нет или произошла ошибка.
mysql_store_result_nonblocking() возвращает индикатор состояния enum net_async_status и принимает второй аргумент result, который является адресом указателя на MYSQL_RESULT, в который необходимо сохранить результат набора данных. Когда возвращаемое состояние равно NET_ASYNC_COMPLETE, аргумент result имеет значение NULL, если набора результатов нет или произошла ошибка.

mysql_store_result_nonblocking() была добавлена в MySQL 8.0.16.

Значения возврата

Возвращает значение enum net_async_status. Подробное описание см. в Разделе 7.2, “C API Асинхронный интерфейс Структуры данных”. Возвращаемое значение NET_ASYNC_ERROR указывает на ошибку.

Когда возвращаемое состояние равно NET_ASYNC_COMPLETE, аргумент result имеет значение NULL, если набора результатов нет или произошла ошибка. Для определения возникновения ошибки, проверьте, возвращает ли mysql_error() непустую строку, возвращает ли mysql_errno() ненулевое значение или возвращает ли mysql_field_count() ноль.

Пример

См. Главу 7, C API Асинхронный интерфейс.