as_DBMGetRecordAllFields

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

Syntax
DBMErr as_DBMGetRecordAllFields(ScanId scanId, RecId recId, int numExistFields, FieldData *fieldData);

Parameters
scanId스캔 ID
recId레코드의 ID
numExistFields레코드에 존재하는 필드의 개수
filedDataFieldData의 배열로, 레코드 필드들의 값을 얻어옴

Returns
value설명
DBM_OK성공적으로 수행된 경우
DBM_INVALID_SCAN_ID주어진 스캔 id를 갖는 스캔이 존재하지 않는 경우
DBM_INVALID_REC_ID주어진 레코드 id를 갖는 레코드가 존재하지 않는 경우
DBM_INVALID_FIELD_INFOnumExistFields가 실제 Field의 개수보다 적게 넘어왔을 경우
DBM_INVALID_FIELD_LEN len이 적절하지 않은 경우
( len>=실제 필드 길이)
DBM_EMPTY_FIELD레코드에 해당 필드값이 존재하지 않을 때
DBM_DB_NOT_INITED 데이타베이스가 초기화되어 있지 않은 경우
DBM_FAIL데이타베이스 내부 오류

Comments
as_DBMGetNextRecordId, as_DBMGetPrevRecordId 에서 얻은 정보를 이용하여 numExistFields를 구하여, fieldData를 위한 메모리를 할당한 후 위의 함수를 사용해야한다.

BLOB 필드도 다른 필드와 마찬가지로 직접 필드값을 content에 넣어서 반환한다.

문자열 또는 BLOB 필드의 경우, 응용 프로그램은 as_DBMGetRecFieldInfo함수를 이용하거나 as_DBMGetNextRecordId, as_DBMGetPrevRecordId 에서 얻은 정보를 이용하여 fieldData[i].content에 대한 메모리를 미리 할당해줘야 한다.

Example
/* Get scanId and recId. See the example of as_DBMDeleteFieldContent */
DBMErr ret;
FieldId fieldId = 1;
FieldData *fieldData;
FieldDataInfo fieldDataInfo[NUM_FIELDS];
S32 numFields;
S32 i;

ret = as_DBMGetRecFieldInfo(scanId, recId, &numFields, fieldDataInfo);
if (ret < DBM_OK) // error handling
fieldData = (FieldData*)malloc(sizeof(FieldData)*numFields);
for (i=0; i < numFields; i++)
{
   if (fieldDataInfo[i].type == DBM_STRING || fieldDataInfo[i].type == DBM_BLOB)
     fieldData[i].content = (char*)malloc(sizeof(char)*fieldDataInfo[i].len);
}

ret = as_DBMGetRecordAllFields(scanId, recId, numFields, fieldData);
if (ret < DBM_OK) // error handling
...