1. 형식: result= msqlFieldSeek(mres_ptr, field_no)
2. 기능: 인자 mres_ptr의 항목에 대한 필드 커서를 이동시키며 msqlFetchField()
함수로 필드 커서의 위치에 있는 항목의 정보를 얻어올 때 사용한다.
3. 설명
(1) 이 함수는 mSQL에서 지원하는 함수이며 함수명은 mSQL의 C API와 동일하다.
(2) 인자 mres_ptr은 mSQL result 포인터이며 msqlStoreResult()함수나 기타
결과를 저장하는 함수에 의하여 얻은 값이어야 하고 mSQL result 포인터가
아니면 에러 처리되며, 이미 해제된 mSQL result 포인터일 때에는 경고
메시지를 출력하고 result에 -1 의 값을 되돌린다.
(3) 인자 field_no는 항목에 대한 순번( 0 부터 항목개수 - 1 )이며 이 값이
문자열이고 수치로 변환될 수 없을 때는 에러 처리된다.
(4) 인자 field_no가 0 보다 작거나 또는 항목의 개수보다 크거나 같으면 정수
-1 이 result에 돌려진다.
(5) 위의 설명(2)나 설명(4)의 경우가 아니면 정수 1 이 result에 돌려진다.
4. 사용예
msql= msqlConnect(NULL); // localhost를 연결한다.
if(msql==MSQL_ERR) { print("mSQL 서버 연결 에러!\n"); return(-1); }
if(msqlSelectDB(msql, "welhelp")==MSQL_ERR) // welhelp database 선택
{
print("welhelp database 선택 에러!\n"); return(-1);
}
mres= msqlListFields(msql, "addr"); // addr 테이블의 항목 리스트 얻기
if(mres==MSQL_ERR) { print("addr error!\n"); return(-1); }
msqlFieldSeek(mres, 2); // 3번째 항목으로 필드 커서를 이동한다.
fd= msqlFetchField(mres); // 필드 커서의 항목에 대한 정보를 얻는다.
printf("항목: %s, 테이블: %s, 자료형: %s [%d], 크기: %lu, 플래그: %X\n",
fd.name, fd.table, fd.type, fd.type_value, fd.length, fd.flags);
msqlFreeResult(mres); msqlClose(msql);
------------------------------ [ 출력결과 ] ------------------------------
항목: address, 테이블: addr, 자료형: char [2], 크기: 120, 플래그: 0
|