23.8.11.21 mysql_stmt_prepare()
int mysql_stmt_prepare(MYSQL_STMT *stmt, const char
*stmt_str, unsigned long length)
설명
mysql_stmt_init() 에 의해 문 핸들이 반환하면 문자열 stmt_str 의해 지시되는 SQL 문을 준비하고 상태 값을 반환합니다. 문자열의 길이는 length 인수에 의해 지정하십시오. 문자열은 하나의 SQL 문으로 구성되어 있어야합니다. 문에 종단의 세미콜론 ( " ; ") 또는 \g 을 추가하지 마십시오.
응용 프로그램은 물음표 ( ? ) 문자를 SQL 문자열의 적절한 위치에 삽입하여 하나 이상의 파라미터 마커를 SQL 문에 포함 할 수 있습니다.
마커는 SQL 문 내의 특정 위치에서만 합법적입니다. 예를 들어, 그들은 INSERT 문의 VALUES() 리스트 (행의 열 값을 지정하기 위해)에서 또는 비교 값을 지정하는 WHERE 절의 컬럼과의 비교에서 사용할 수 있습니다. 그러나 그들은 식별자 (테이블 또는 컬럼 이름 등) 또는 = 등호 등의 바이너리 연산자의 두 피연산자에 지정하는 데 사용할 수 없습니다. 파라미터의 형태를 결정하는 것은 불가능한 경우가 있기 때문에 후자의 제한은 필요합니다. 일반적으로 매개 변수는 Data Manipulation Language (DML) 문 내에서만 정당, Data Definition Language (DDL) 문에서 허용되지 않습니다.
매개 변수 마커는 문을 실행하기 전에 mysql_stmt_bind_param() 를 사용하여 응용 프로그램 변수에 바인딩되어 있어야합니다.
준비된 문에서 참조되는 테이블이나 뷰의 메타 데이터 변경이 감지되고 그것이 다음 실행 때 문이 자동으로 다시 준비됩니다. 자세한 내용은 섹션 8.9.4 "준비된 문 및 저장 프로그램 캐시" 를 참조하십시오.
반환 값
성공의 경우는 제로. 오류가 발생한 경우 0이 아닌.
오류
CR_COMMANDS_OUT_OF_SYNC명령이 잘못된 순서로 실행되었습니다.
CR_OUT_OF_MEMORY메모리 부족.
CR_SERVER_GONE_ERRORMySQL 서버가 존재하지 않습니다.
CR_SERVER_LOST쿼리 중에 서버에 연결이 끊어졌습니다.
CR_UNKNOWN_ERROR알 수없는 오류가 발생했습니다.
준비 작업이 실패한 (즉, mysql_stmt_prepare() 0이 아닌 반환) 경우 mysql_stmt_error() 를 호출하여 오류 메시지를 얻을 수 있습니다.
Example
섹션 23.8.11.10 "mysql_stmt_execute ()" 의 예를 참조하십시오.