DBMGetRecordField

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

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

Parameters
scanId스캔 ID
recId 레코드의 ID
fieldId 필드의 ID
lencontent에 할당된 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 필드의 경우, 응용 프로그램은 DBMGetFieldLength함수를 이용하거나 DBMGetNextRecordId, DBMGetPrevRecordId에서 얻은 정보를 이용하여 content에 대한 메모리를 미리 할당해줘야 한다.

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

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

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

  ...