입력의 경우 mysql_stmt_bind_param() 에서 MYSQL_BIND 구조를 사용하여 매개 변수 데이터 값을 mysql_stmt_execute() 에서 사용하기 위해 버퍼에 바인딩합니다.

출력의 경우는 mysql_stmt_bind_result() 에서 MYSQL_BIND 구조를 사용하여 mysql_stmt_fetch() 에 의해 행 페치에서 사용하기 위해 버퍼를 결과 집합 열에 바인딩합니다.

enum enum_field_types buffer_type

버퍼의 종류. 이 멤버는 문 매개 변수 또는 결과 세트 컬럼에 바인딩되어있는 C 언어 변수의 데이터 형식을 나타냅니다. 입력의 경우, buffer_type 은 서버로 전송되는 값을 저장하는 변수의 형태를 나타냅니다. 출력의 경우, 그것은 서버에서받은 값을 저장해야 할 변수 유형을 나타냅니다. 허용되는 buffer_type 값은 섹션 23.8.9.1 "C API Prepared Statement 유형 코드" 를 참조하십시오.

void *buffer

데이터 전송에 사용되는 버퍼의 포인터. 이것은 C 언어 변수의 주소입니다.

입력의 경우 buffer 는 문 매개 변수의 데이터 값을 저장하는 변수에 대한 포인터입니다. mysql_stmt_execute() 를 호출하면, MySQL은 문에서 해당 매개 변수 마커 (문 문자열에 ? 로 지정되는) 대신에 변수에 저장되어있는 값을 사용합니다.

출력의 경우, buffer 는 결과 세트 컬럼 값을 반환하는 변수에 대한 포인터입니다. mysql_stmt_fetch() 를 호출하면, MySQL은 결과 세트의 현재 행의 열 값을 변수에 저장합니다. 호출이 돌아 오면 값에 액세스 할 수 있습니다.

MySQL은 클라이언트 측의 C 언어 값과 서버 측의 SQL 값 사이의 유형 변환을 수행 할 필요성을 최소화하려면 해당 SQL 값의 형태와 유사한 형태를 가지는 C 변수를 사용합니다.

C 형과 SQL 형 간의 매핑 지침 및 형식 변환에 관한주의 사항은 섹션 23.8.9.1 "C API Prepared Statement 유형 코드" 및 섹션 23.8.9.2 "C API Prepared Statement 형 변환" 을 참조하십시오.

unsigned long buffer_length

*buffer 의 바이트의 실제 크기입니다. 이것은 버퍼에 저장할 수있는 최대 데이터 양을 나타냅니다. 문자 및 바이너리 C 데이터의 경우 buffer_length 값은 입력 값을 지정하는 mysql_stmt_bind_param() 와 함께 사용했을 때 *buffer 의 길이 또는 mysql_stmt_bind_result() 와 함께 사용하면 버퍼에 가져올 수 출력 데이터 바이트의 최대 수를 지정합니다.

unsigned long *length

*buffer 에 저장된 데이터의 실제 바이트 수를 나타내는 unsigned long 변수에 대한 포인터. length 는 문자 또는 이진 C 데이터에 사용됩니다.

입력 파라미터 데이터 바인딩의 경우 *buffer 에 저장된 파라미터 값의 실제 길이를 같이 *length 를 설정합니다. 이것은 mysql_stmt_execute() 에서 사용됩니다.

출력 값 바인딩의 경우, mysql_stmt_fetch() 를 호출 할 때, MySQL에 의해 *length 가 설정됩니다. mysql_stmt_fetch() 의 반환 값에 의해 길이의 해석 방법을 결정합니다.

buffer_type 값에 따라 데이터 값의 길이가 결정되기 때문에 length 는 숫자와 시간 데이터 형에 대해서는 무시됩니다.

반환 값의 길이를 페치하기 전에 확인해야 할 경우 몇 가지 전략에 대한 섹션 23.8.11.11 "mysql_stmt_fetch ()" 를 참조하십시오.

my_bool *is_null

이 멤버는 값이 NULL 의 경우에 true로, 그것이 NULL 이 아닌 경우 false 인 my_bool 변수를 지시합니다. 입력은 *is_null 를 true로 설정하여 문 매개 변수로 NULL 값을 전달하는 것을 나타냅니다.

is_null 은 boolean 스칼라 포인터에 NULL 값 지정 방법의 유연성을 제공합니다.

출력의 경우 행을 인출하면 MySQL은 문에서 반환 된 결과 세트 컬럼 값이 NULL 인지 여부에 따라 is_null 에서 지시되는 값을 true 또는 false로 설정합니다.

my_bool is_unsigned

이 멤버는 unsigned ( char , short int , int , long long int )를 지정된 유형을 가진 C 변수에 적용됩니다. buffer 에 의해 지시되는 변수가 unsigned 의 경우 is_unsigned 를 true로 설정하고 그렇지 않으면 false로 설정합니다. 예를 들어, signed char 변수를 buffer 에 바인드 할 경우 MYSQL_TYPE_TINY 유형 코드를 지정하고 is_unsigned 를 false로 설정합니다. 대신에 unsigned char 를 바인드하는 경우, 타입 코드는 동일하지만 is_unsigned 를 true로하십시오. ( char 의 경우 그것은 부호 첨부 나 부호 없음인지 정의되지 않기 때문에 signed char 와 unsigned char 를 사용하여 부호의 유무를 명시하는 것이 좋습니다.)

is_unsigned 는 클라이언트 측의 C 언어 변수에만 적용됩니다. 그것은 서버 측의 대응하는 SQL 값의 부호의 유무에 대해서는 아무것도 나타내지 않습니다. 예를 들어, int 변수를 사용하여 BIGINT UNSIGNED 컬럼의 값을 제공하는 경우 int 는 부호있는 형태이기 때문에 is_unsigned 는 false로해야합니다. unsigned int 변수를 사용하여 BIGINT 컬럼의 값을 제공하는 경우, unsigned int 는 부호없는 형식이기 때문에 is_unsigned 를 true로해야합니다. MySQL은 부호있는 값과 부호없는 값으로 양방향으로 올바른 변환을 수행하지만 잘림이 발생하면 경고가 생성됩니다.

my_bool *error

출력의 경우,이 멤버를 my_bool 변수를 가리 키도록 설정하고 행 페 다음에는 거기에 포함되는 파라미터 잘림 정보를 보유하고 있습니다. 잘린 보고서를 사용하면 mysql_stmt_fetch() 는 MYSQL_DATA_TRUNCATED 을 돌려 절단이 발생한 파라미터의 MYSQL_BIND 구조에서 *error 가 true가됩니다. 잘라내 기는 부호 또는 자리 빠짐 또는 문자열이 너무 길어서 컬럼에 들어 가지 않았 음을 나타냅니다. 잘린 보고서는 기본적으로 활성화되어 있지만 MYSQL_REPORT_DATA_TRUNCATION 옵션을 사용하여 mysql_options() 를 호출하여 제어 할 수 있습니다.