22.8.9. C API Готовые Структуры данных Оператора

Для ввода использовать 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 значения, см. Раздел 22.8.9.1, "API C Готовые Коды Типа Оператора".

void *buffer

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

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

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

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

Для направляющих линий об отображении между типами C и типами SQL и примечаниями о преобразованиях типов, см. Раздел 22.8.9.1, "API C Готовые Коды Типа Оператора", и Раздел 22.8.9.2, "API C Готовые Преобразования типов Оператора".

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 значение определяет длину значения данных.

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

my_bool *is_null

Этот элемент указывает на a my_bool переменная, которая является истиной, если значение NULL, ложь, если это не NULL. Для ввода, набора *is_null к истине, чтобы указать, что Вы передаете a NULL оцените как параметр оператора.

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

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

my_bool is_unsigned

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

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

my_bool *error

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