6.4.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(). Её можно вызывать несколько раз для отправки частей значения символьных или бинарных данных для столбца, который должен быть одним из типов данных или .

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

Примечание

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

Чтобы сбросить/забыть отправленные данные, вызовите mysql_stmt_reset(). Смотрите Раздел 6.4.22, «mysql_stmt_reset()».

Системная переменная управляет максимальным размером значений параметров, которые можно отправить с помощью mysql_stmt_send_long_data().

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

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

Ошибки

Параметр не имеет строкового или бинарного типа.
Неверный номер параметра.
Команды были выполнены в неправильном порядке.
Сервер MySQL недоступен.
Отсутствует память.
Произошла неизвестная ошибка.

Пример

В следующем примере показано, как отправлять данные для столбца частями. Он вставляет значение данных '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);
}