DBMGetNextRecordIdWithFlag

Description
주어진 스캔의 현재 레코드로부터 StatusFlag(ARCHIVE_FLAG, ADD_FLAG, MODIFY_FLAG, DELETE_FLAG)가 set되어있는 레코드를 검색하여, 해당 레코드의 Id와 관련 정보를 구한다.

Syntax
DBMErr DBMGetNextRecordIdWithFlag(ScanId scanId, RecId* recId, P_S32 numExistFields, FieldDataInfo* fieldDataInfo, P_U8 status);

Parameters
scanId open된 스캔 ID
recId 다음 레코드의 ID
numExistFields 레코드에 실제 값이 존재하는 필드의 수
fieldDataInfo레코드에 실제 값이 존재하는 필드들에 대한 정보
status반환되는 레코드의 상태정보

Returns
value설명
DBM_OK 레코드 id를 성공적으로 구한 경우
(인덱스 스캔의 경우는 DBM_OK 대신 DBM_OK _MATCH나 DBM_OK_UNMATCH가 사용된다. )
DBM_OK_MATCH 다음 레코드 id를 성공적으로 구한 경우
인덱스 스캔에만 사용되는 값이며, 이는 다음 레코드가 인덱스 스캔 open시 설정한 조건에 맞는 레코드 임을 의미한다.
DBM_OK_UNMATCH 다음 레코드 id를 성공적으로 구한 경우
인덱스 스캔에만 사용되는 값이며, 이는 다음 레코드가 인덱스 스캔 open시 설정한 조건에 맞지않는 레코드 임을 의미한다.
DBM_NO_MORE_REC더 이상 레코드가 없는 경우
DBM_EMPTY_TABLE테이블에 레코드가 전혀 없는 경우
DBM_EMPTY_CAT 해당 Category에 레코드가 전혀 없는 경우
(Category에 대한 스캔인 경우에만 사용하는 값)
DBM_INVALID_SCAN_ID주어진 스캔 id를 갖는 스캔이 존재하지 않는 경우
DBM_DB_NOT_INITED데이타베이스가 초기화되어 있지 않은 경우
DBM_OUT_OF_DATE_SCAN해당 스캔이 사용하는 인덱스가 변경된 경우

Comments
응용 프로그램에서 테이블에 존재하는 전체 필드 수 이상의 FieldDataInfo 배열을 생성해서 매개변수로 넘겨야 한다. 그러면 실제 존재하는 수 만큼의 필드 데이타에 대한 정보를 반환해준다.

매개변수 fieldDataInfo의 자료구조는 다음과 같다.

typedef struct {
  FieldId id;
  FieldDataType type ;
  S32 len ;
} FieldDataInfo ;

DBM_OK_MATCH, DBM_OK_UNMATCH는 인덱스 스캔에만 사용되는 값이다. 검색되는 레코드가 스캔 open당시 설정된 key 값과 match되는 레코드인 경우, DBM_OK_MATCH를 리턴하고, 그렇지 않은 경우에는 DBM_OK_UNMATCH를 리턴한다.

스캔을 Open하고 DBMInsertRecord, DBMDeleteRecord, DBMSetFieldContent(인덱스 필드 값 변경)를 수행한 후에는 DBMGetNextRecordId를 사용할 수 없다. 인덱스가 변경되었으므로 스캔에서 올바른 레코드를 얻을 수 없기 때문이다.

See Also
DBMGetNextRecordId

Example

  TableId tableId; ScanId scanId; RecId recId; DBMErr ret=DBM_OK;
  S32 numFields, numExistFields; FieldDataInfo *fieldDataInfo;
  FieldData fieldData; U8 status;
  // get tableId
  ret = DBMOpenSeqScanTable( tableId, NULL_CAT_ID, DBM_PRIM, 0, DBM_INCR, &scanId);
  if( ret < DBM_OK ) // error handling
  ret = DBMGetNumFieldsInTable(tableId, &numFields);
  ...
  /* allocate space for fieldDataInfo */
  fieldDataInfo =(FieldDataInfo*)Lmalloc( sizeof(FieldDataInfo) * numFields );
  ret=DBMGetNextRecordIdWithFlag( scanId, &recId, &numExistFields, fieldDataInfo, &status)
  while(ret >= DBM_OK ) {
    /*memory allocation for field data and assign fieldDataInfo to fieldData*/

    ret = DBMGetRecordAllFields( scanId, recId, fieldId, len, fieldDataType, content );
    if( status & ( DBM_ON << SECRET_FLAG ) )
      // process for record which SECRET_FLAG is set
    if( status & ( DBM_ON << ADD_FLAG ) )
      // process for record which ADD_FLAG is set
    ...
    ret=DBMGetNextRecordIdWithFlag(scanId,&recId,&numExistFields, fieldDataInfo, &status)
  }