as_DBMGetRecordField

as_DBMGetRecordField

Description
특정 레코드의 특정 필드값을 읽는다.

Syntax
DBMErr as_DBMGetRecordField(ScanId scanId, RecId recId, FieldId fieldId, S32 len, P_S32 fieldDataType, void* content);

Parameters

scanId	스캔 ID
recId	레코드의 ID
fieldId	필드의 ID
len	content에 할당된 byte 수
content	필드의 데이타 값 문자열 필드인 경우 끝에 '\0'이 들어있다
fieldType	필드의 데이타 타입

Returns

value	설명
DBM_OK	성공적으로 수행된 경우
DBM_INVALID_SCAN_ID	주어진 스캔 id를 갖는 스캔이 존재하지 않는 경우
DBM_INVALID_REC_ID	주어진 레코드 id를 갖는 레코드가 존재하지 않는 경우
DBM_INVALID_FIELD_ID	주어진 필드 id가 테이블 스키마에 존재하지 않는 경우
DBM_INVALID_FIELD_LEN	len이 적절하지 않은 경우 ( " len>=실제 필드 길이" 조건을 만족해야 함)
DBM_EMPTY_FIELD	레코드에 해당 필드값이 존재하지 않을 때
DBM_DB_NOT_INITED	데이타베이스가 초기화되어 있지 않은 경우

Comments
BLOB 필드도 다른 필드와 마찬가지로 직접 필드값을 content에 넣어서 반환한다.
문자열 또는 BLOB 필드의 경우, 응용 프로그램은 as_DBMGetRecFieldInfo함수를 이용하거나 as_DBMGetNextRecordId, as_DBMGetPrevRecordId 에서 얻은 정보를 이용하여 content에 대한 메모리를 미리 할당해줘야 한다.

Example
/* Get scanId and recId. See the example of as_DBMDeleteFieldContent */

FieldId fieldId = 1;
int len;
void *content;
int fieldType;

ret = as_DBMGetFieldLength(scanId, recId, fieldId, &len);
if (ret < DBM_OK) // error handling
content = (void *)malloc(len);
ret = as_DBMGetRecordField(scanId, recId, fieldId, len, &fieldType, content);
if (ret < DBM_OK) // error handling
...