8.4.3.181 mysql_real_query()

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

8.4.3.182 Описание

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

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

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

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

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

8.4.3.184 Ошибки

CR_COMMANDS_OUT_OF_SYNC

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

CR_SERVER_GONE_ERROR

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

CR_SERVER_LOST

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

CR_UNKNOWN_ERROR

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

User Comments

If a result set (MYSQL_RES) is in use, then mysql_free_result(...) must be called before a call to this function will be successful.

I.e. If mysql_use_result or mysql_store_result was called, then mysql_free_result must be called before mysql_real_query can be called successfully.

Add your own comment.