Spec-Zone .ru
спецификации, руководства, описания, API
|
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()
. См. Раздел
21.8.11.22,"mysql_stmt_reset()
".
max_allowed_packet
системная переменная управляет максимальным размером значений параметра, которые могут быть отправлены с mysql_stmt_send_long_data()
.
Нуль, если данные отправляются успешно серверу. Ненулевой, если ошибка произошла.
У параметра нет строки или двоичного типа.
Команды выполнялись в неподходящем порядке.
Сервер MySQL ушел.
Из памяти.
Произошла неизвестная ошибка.
Следующий пример демонстрирует, как отправить данные за 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);}