int
mysql_stmt_prepare(MYSQL_STMT *stmt,
                   const char *stmt_str,
                   unsigned long length)

Используя дескриптор запроса, возвращённый функцией mysql_stmt_init(), подготавливает SQL-запрос, указанный строкой stmt_str, и возвращает значение статуса. Длина строки должна быть указана аргументом length. Строка должна содержать один SQL-запрос. Не добавляйте завершающую точку с запятой (;) или \g к запросу.

Приложение может включать один или несколько маркеров параметров в SQL-запрос, вставляя символы вопроса (?) в строку SQL в соответствующих позициях.

Маркеры допустимы только в определённых местах SQL-запросов. Например, они разрешены в списке VALUES() запроса (для указания значений столбцов для строки) или в сравнении со столбцом в WHERE запроса, чтобы указать значение сравнения. Однако они не разрешены для идентификаторов (например, имен таблиц или столбцов) или для указания обоих операндов бинарного оператора, такого как = знак равенства. Последнее ограничение необходимо, потому что невозможно определить тип параметра. В целом, параметры допустимы только в операторах языка манипулирования данными (DML), а не в операторах языка определения данных (DDL).

Маркеры параметров должны быть связаны с переменными приложения с помощью функции mysql_stmt_bind_param() до выполнения запроса.

Изменения метаданных таблиц или представлений, к которым обращаются подготовленные запросы, обнаруживаются и вызывают автоматическую повторную подготовку запроса при его последующем выполнении. Для получения дополнительной информации см. .

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

Если операция подготовки не удалась (то есть функция mysql_stmt_prepare() возвращает значение, отличное от нуля), сообщение об ошибке можно получить, вызвав функцию mysql_stmt_error().

См. пример в разделе 6.4.10, «mysql_stmt_execute()».