Spec-Zone .ru
спецификации, руководства, описания, API

22.8.11.26. mysql_stmt_send_long_data()

my_bool mysql_stmt_send_long_data(MYSQL_STMT *stmt, unsigned int parameter_number, const char *data, unsigned long length)

Описание

Позволяет приложению отправить данные параметра серверу в частях (или "блоки"). Вызовите эту функцию после mysql_stmt_bind_param() и прежде mysql_stmt_execute(). Это можно вызвать многократно, чтобы отправить части символа или значения двоичных данных для столбца, который должен быть одним из TEXT или BLOB типы данных.

parameter_number указывает который параметр связать данные с. Параметры нумеруются, начинаясь 0. data указатель на буферное, содержащее данные, которые будут отправлены, и length указывает на число байтов в буфере.

Отметить

Следующее mysql_stmt_execute() вызов игнорирует связывать буфер для всех параметров, которые использовались с mysql_stmt_send_long_data() с тех пор последний mysql_stmt_execute() или mysql_stmt_reset().

Если Вы хотите сбросить/забыть отправленные данные, можно сделать это с mysql_stmt_reset(). См. Раздел 22.8.11.22,"mysql_stmt_reset()".

С MySQL 5.6.3, max_allowed_packet системная переменная управляет максимальным размером значений параметра, которые могут быть отправлены с mysql_stmt_send_long_data().

Возвращаемые значения

Нуль, если данные отправляются успешно серверу. Ненулевой, если ошибка произошла.

Ошибки

Пример

Следующий пример демонстрирует, как отправить данные за a TEXT столбец в блоках. Это вставляет значение данных 'MySQL - The most popular Open Source database' в text_column столбец. mysql переменная, как предполагается, является допустимым дескриптором соединения.

#define INSERT_QUERY "INSERT INTO \                      test_long_data(text_column) VALUES(?)"MYSQL_BIND bind[1];long       length;stmt = mysql_stmt_init(mysql);if (!stmt){  fprintf(stderr, " mysql_stmt_init(), out of memory\n");  exit(0);}if (mysql_stmt_prepare(stmt, INSERT_QUERY, strlen(INSERT_QUERY))){  fprintf(stderr, "\n mysql_stmt_prepare(), INSERT failed");  fprintf(stderr, "\n %s", mysql_stmt_error(stmt));  exit(0);} memset(bind, 0, sizeof(bind)); bind[0].buffer_type= MYSQL_TYPE_STRING; bind[0].length= &length; bind[0].is_null= 0;/* Bind the buffers */if (mysql_stmt_bind_param(stmt, bind)){  fprintf(stderr, "\n param bind failed");  fprintf(stderr, "\n %s", mysql_stmt_error(stmt));  exit(0);} /* Supply data in chunks to server */ if (mysql_stmt_send_long_data(stmt,0,"MySQL",5)){  fprintf(stderr, "\n send_long_data failed");  fprintf(stderr, "\n %s", mysql_stmt_error(stmt));  exit(0);} /* Supply the next piece of data */ if (mysql_stmt_send_long_data(stmt,0,           " - The most popular Open Source database",40)){  fprintf(stderr, "\n send_long_data failed");  fprintf(stderr, "\n %s", mysql_stmt_error(stmt));  exit(0);} /* Now, execute the query */ if (mysql_stmt_execute(stmt)){  fprintf(stderr, "\n mysql_stmt_execute failed");  fprintf(stderr, "\n %s", mysql_stmt_error(stmt));  exit(0);}