DBMGetPrevRecordIdWithJump

DBMGetPrevRecordIdWithJump

Description
주어진 스캔의 현재 레코드 위치로부터 특정 개수만큼 떨어져있는 이전 레코드 ID와 필드 관련 정보를 구한다.

Syntax
DBMErr DBMGetPrevRecordIdWithJump(ScanId scanId, S32 numJumps, RecId* recId, P_S32 numExistFields, FieldDataInfo* fieldDataInfo);

Parameters

scanId	open된 스캔 ID
numJumps	구하고자 하는 이전 레코드가 현재 레코드로부터 떨어져 있는 위치정보(offset)
recId	이전 레코드의 ID
numExistFields	레코드에 실제 값이 존재하는 필드의 수
fieldDataInfo	레코드에 실제 값이 존재하는 필드들에 대한 정보

Returns

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

Comments
DBMGetPrevRecordId를 여러 번 호출하는 것과 같은 기능을 하는 함수이다.

그러므로, Scan을 open한 이후 레코드 id를 구하는 최초의 호출이라면, scan에 해당되는 최초의 레코드로부터의 numJumps-1만큼 떨어진 이전 레코드를 구하게 된다는 점에 유의해야 한다. 즉, scan에 대한 최초의 호출이면서 numJumps==1인 경우, 최초의 레코드를 구하게 된다.

응용 프로그램에서 테이블에 존재하는 전체 필드 수 이상의 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
DBMGetPrevRecordId, DBMGetNextRecordIdWithJump

Example

  TableId tableId; ScanId scanId; RecId recId; DBMErr ret=DBM_OK;
  S32 numFields, numExistFields; FieldDataInfo fieldDataInfo;
  FieldData fieldData;

  S32 numJumps;
  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 );
  numJumps = 2;
  while( (ret = DBMGetPrevRecordIdWithJump( scanId, &recId, &numExistFields, fieldDataInfo, numJumps) >= DBM_OK ) {
     /*memory allocation for field data and assign fieldDataInfo to fieldData*/
     fieldData = (FieldData*)Lmalloc( sizeof(FieldData) *numExistFields);
     ...
     ret = DBMGetRecordAllFields( scanId, recId, fieldId, len, fieldDataType, content );
     ...
  }