5.4.62 mysql_real_query()

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

Описание

Примечание

mysql_real_query() — это синхронная функция. Её асинхронный аналог — mysql_real_query_nonblocking(), предназначенный для применений, требующих асинхронного взаимодействия с сервером. См. Главу 7, C API Асинхронный интерфейс.

mysql_real_query() выполняет SQL-запрос, на который указывает stmt_str, строка длиной length байт. Обычно строка должна содержать единственный SQL-запрос без завершающей точки с запятой (;) или \g. Если выполнение нескольких запросов включено, строка может содержать несколько запросов, разделённых точками с запятой. См. Раздел 3.6.3, «Поддержка выполнения нескольких запросов».

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

Чтобы определить, возвращает ли запрос набор результатов, вызовите mysql_field_count(). См. Раздел 5.4.23, «mysql_field_count()».

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

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

Ошибки

Команды были выполнены в неправильном порядке.
Сервер MySQL вышел из строя.
Соединение с сервером было потеряно во время запроса.
Произошла неизвестная ошибка.