Для ввода используйте структуры MYSQL_BIND с mysql_stmt_bind_param() для привязки значений параметров к буферам, используемым mysql_stmt_execute().

Для вывода используйте структуры MYSQL_BIND с mysql_stmt_bind_result() для привязки буферов к столбцам набора результатов, для использования при извлечении строк с помощью mysql_stmt_fetch().

enum enum_field_types buffer_type

Тип буфера. Этот член указывает тип данных переменной языка C, привязанной к параметру запроса или столбцу набора результатов. Для ввода buffer_type указывает тип переменной, содержащей значение, которое будет отправлено на сервер. Для вывода он указывает тип переменной, в которую должно быть сохранено значение, полученное от сервера. Для допустимых значений buffer_type см. Раздел 6.2.1, «Типы данных C API подготовленных запросов».

void *buffer

Указатель на буфер, используемый для передачи данных. Это адрес переменной языка C.

Для ввода buffer является указателем на переменную, в которой хранится значение данных для параметра запроса. При вызове mysql_stmt_execute(), MySQL использует значение, хранящееся в переменной, вместо соответствующего маркера параметра в запросе (указанный с помощью ? в строке запроса).

Для вывода buffer является указателем на переменную, в которую возвращается значение столбца набора результатов. При вызове mysql_stmt_fetch(), MySQL сохраняет значение столбца из текущей строки набора результатов в этой переменной. Вы можете получить доступ к значению при возвращении вызова.

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

Для рекомендаций по сопоставлению типов языка C и типов SQL и примечаний по преобразованиям типов см. Раздел 6.2.1, «Типы данных C API подготовленных запросов» и Раздел 6.2.2, «Преобразование типов C API подготовленных запросов».

unsigned long buffer_length

Фактический размер *buffer в байтах. Это указывает на максимальное количество данных, которое может храниться в буфере. Для символьных и бинарных данных языка C значение buffer_length определяет длину *buffer при использовании с mysql_stmt_bind_param() для указания входных значений или максимальное количество байтов выходных данных, которые могут быть извлечены в буфер при использовании с mysql_stmt_bind_result().

unsigned long *length

Указатель на переменную unsigned long, которая указывает фактическое количество байтов данных, хранящихся в *buffer. length используется для символьных или бинарных данных языка C.

Для привязки входных данных параметров установите *length, чтобы указать фактическую длину значения параметра, хранящегося в *buffer. Это используется mysql_stmt_execute().

Для привязки выходных значений MySQL устанавливает *length при вызове mysql_stmt_fetch(). Значение возврата mysql_stmt_fetch() определяет, как интерпретировать длину:

length игнорируется для числовых и временных типов данных, потому что значение buffer_type определяет длину значения данных.

Если вам нужно определить длину возвращаемого значения перед его извлечением, см. Раздел 6.4.11, «mysql_stmt_fetch()», для некоторых стратегий.

my_bool *is_null

Этот член указывает на переменную my_bool, которая имеет значение true, если значение NULL, и false, если оно не NULL. Для ввода установите *is_null в значение true, чтобы указать, что вы передаёте значение NULL как параметр запроса.

is_null является указателем на булеву переменную, а не булевым значением, чтобы обеспечить гибкость в способе указания NULL значений:

Для вывода, когда вы извлекаете строку, MySQL устанавливает значение, на которое указывает is_null, в true или false в зависимости от того, является ли возвращаемое из запроса значение столбца набора результатов NULL или нет.

my_bool is_unsigned

Этот член применяется для переменных языка C с типами данных, которые могут быть unsigned (char, short int, int, long long int). Установите is_unsigned в значение true, если переменная, на которую указывает buffer, является unsigned, и в false в противном случае. Например, если вы привязываете переменную signed char к buffer, укажите код типа MYSQL_TYPE_TINY и установите is_unsigned в false. Если вы привязываете вместо этого unsigned char, код типа остается тем же, но is_unsigned должно быть true. (Для char не определено, является ли он знаковым или беззнаковым, поэтому лучше явно указать знаковое представление, используя signed char или unsigned char.)

is_unsigned применяется только к переменной языка C на стороне клиента. Это ничего не говорит о знаковом представлении соответствующего значения SQL на стороне сервера. Например, если вы используете переменную int для указания значения для столбца BIGINT UNSIGNED, is_unsigned должно быть false, потому что int является знаковым типом. Если вы используете переменную unsigned int для указания значения для столбца, is_unsigned должно быть true, потому что unsigned int является беззнаковым типом. MySQL выполняет правильное преобразование между знаковыми и беззнаковыми значениями в обоих направлениях, хотя предупреждение возникает, если происходит усечение.

my_bool *error

Для вывода установите этот член для указания на переменную my_bool, чтобы получить информацию об усечении для параметра, сохраненного там после операции извлечения строки. При включённом отслеживании усечения mysql_stmt_fetch() возвращает MYSQL_DATA_TRUNCATED и *error имеет значение true в структурах MYSQL_BIND для параметров, в которых произошло усечение. Усечение указывает на потерю знака или значащих цифр, или что строка была слишком длинной для помещения в столбец. Отслеживание усечения включено по умолчанию, но может быть настроено путём вызова mysql_options() с параметром MYSQL_REPORT_DATA_TRUNCATION.