6.4.5 mysql_stmt_bind_param()

bool
mysql_stmt_bind_param(MYSQL_STMT *stmt,
                      MYSQL_BIND *bind)

Описание

mysql_stmt_bind_param() используется для привязки входных данных к маркерам параметров в SQL-запросе, переданном в mysql_stmt_prepare(). Она использует структуры MYSQL_BIND для предоставления данных. bind — это адрес массива структур MYSQL_BIND. Библиотека ожидает, что массив будет содержать по одному элементу для каждого маркера параметра ?, присутствующего в запросе.

Предположим, вы подготовили следующий запрос:

INSERT INTO mytbl VALUES(?,?,?)

Когда вы привязываете параметры, массив структур MYSQL_BIND должен содержать три элемента и может быть объявлен так:

MYSQL_BIND bind[3];

Для описания членов структуры MYSQL_BIND и того, как их следует установить для предоставления входных значений, см. Раздел 6.2, «Структуры данных подготовленных запросов API C».

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

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

Ошибки

Преобразование не поддерживается. Возможно, значение buffer_type недействительно или не является одним из поддерживаемых типов.
Ошибка выделения памяти.
Произошла неизвестная ошибка.

Пример

См. Пример в Разделе 6.4.11, «mysql_stmt_execute()».