DBMGetRecordAllFields

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

Syntax
DBMErr 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_INFO numExistFields가 실제 Field의 개수보다 적게 넘어왔을 경우
DBM_INVALID_FIELD_LEN len이 적절하지 않은 경우
( len >= 실제 필드 길이 )
DBM_EMPTY_FIELD 레코드에 해당 필드값이 존재하지 않을 때
DBM_DB_NOT_INITED데이타베이스가 초기화되어 있지 않은 경우
DBM_FAIL 데이타베이스 내부 오류

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

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

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

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

  ret = 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 = (S8*)malloc(sizeof(S8)*fieldDataInfo[i].len);
  }

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