as_DBMGetPrevRecordIdWithJump

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

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

Parameters
scanIdopen된 스캔 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
as_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하고 as_DBMInsertRecord, as_DBMDeleteRecord, as_DBMSetFieldContent (인덱스 필드 값 변경)를 수행한 후에는 as_DBMGetNextRecordId 를 사용할 수 없다. 인덱스가 변경되었으므로 스캔에서 올바른 레코드를 얻을 수 없기 때문이다.

See Also
as_DBMGetPrevRecordId, as_DBMGetNextRecordIdWithJump

Example
TableId tableId; ScanId scanId; RecId recId; DBMErr ret=DBM_OK;
S32 numFields, numExistFields; FieldDataInfo fieldDataInfo;
FieldData fieldData;
S32 numJumps;
ret = as_DBMOpenSeqScanTable( tableId, NULL_CAT_ID, DBM_PRIM, 0, DBM_INCR, &scanId);
if( ret < DBM_OK ) // error handling
ret = as_DBMGetNumFieldsInTable(tableId, &numFields);
...
/* allocate space for fieldDataInfo */
 fieldDataInfo =(FieldDataInfo*)Lmalloc( sizeof(FieldDataInfo) * numFields );
numJumps = 2;
while( (ret = as_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 = as_DBMGetRecordAllFields( scanId, recId, fieldId, len, fieldDataType, content );
     ...
 }