8.4. Интерфейс C для MySQL
8.4.3. Описание функций интерфейса C

8.4.3.41. mysql_query()

int mysql_query(MYSQL *mysql, const char *query)

Описание

Выполняет запрос SQL, указанный в аргументе query в виде строки с нулевыми окончаниями. Данный запрос должен состоять из одной команды SQL. Нельзя добавлять к этой команде в качестве завершающих элементов точку с запятой (";") или \g.

Функция mysql_query() не может использоваться для запросов, содержащих двоичные данные; вместо этого необходимо использовать функцию mysql_real_query() (двоичные данные могут содержать символ '\0', который mysql_query() интерпретирует как окончание строки запроса).

Для проверки, вернул данный запрос результирующий набор или нет, можно использовать функцию mysql_field_count(). See Раздел 8.4.3.20, «mysql_field_count()».

Возвращаемые значения

Нуль при успешном выполнении запроса. Величина, отличная от нуля, если произошла ошибка.

Ошибки

• CR_COMMANDS_OUT_OF_SYNC

  Команды были выполнены в ненадлежащем порядке.

• CR_SERVER_GONE_ERROR

  Сервер MySQL неожиданно завершил работу.

• CR_SERVER_LOST

  Соединение с сервером прервалось в процессе данного запроса.

• CR_UNKNOWN_ERROR

  Произошла неизвестная ошибка.