MySQL 5.6 한글메뉴얼

23.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_execute() 또는 mysql_stmt_reset() 에서 mysql_stmt_send_long_data() 에 의해 사용 된 모든 매개 변수 바인딩 버퍼를 무시합니다.

전송 된 데이터를 재설정 / 삭제하는 경우 mysql_stmt_reset() 로 실행할 수 있습니다. 섹션 23.8.11.22 "mysql_stmt_reset ()" 를 참조하십시오.

MySQL 5.6.3 이후 max_allowed_packet 시스템 변수는 mysql_stmt_send_long_data() 에 의해 보낼 수있는 매개 변수 값의 최대 크기를 제어합니다.

반환 값

성공의 경우는 제로. 오류가 발생한 경우 0이 아닌.

오류

CR_INVALID_BUFFER_USE

이 매개 변수는 문자열 또는 이진 형식이 없습니다.
CR_COMMANDS_OUT_OF_SYNC

명령이 잘못된 순서로 실행되었습니다.
CR_SERVER_GONE_ERROR

MySQL 서버가 존재하지 않습니다.
CR_OUT_OF_MEMORY

메모리 부족.
CR_UNKNOWN_ERROR

알 수없는 오류가 발생했습니다.

예

다음 예제에서는 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);
}