Справочное руководство по MySQL
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
- Произошла неизвестная ошибка.
