as_DBMGetPrevRecordId

as_DBMGetPrevRecordId

Description
주어진 스캔의 현재 레코드 위치로부터 이전 레코드 ID와 필드 관련 정보를 구한다.

Syntax
DBMErr as_DBMGetPrevRecordId(ScanId scanId, RecId* recId, P_S32 numExistFields, FieldDataInfo* fieldDataInfo);

Parameters

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

See Also
as_DBMGetPrevRecordIdWithJump, as_DBMGetNextRecordId

Example
TableId tableId; ScanId scanId; RecId recId; DBMErr ret=DBM_OK;
int numFields, numExistFields; FieldDataInfo *fieldDataInfo;
FieldData fieldData;
/* Get tableId */
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 );
ret=as_DBMGetPrevRecordId(scanId,recId,&numExistFields, fieldDataInfo)
while(ret >= DBM_OK ) {
   /*memory allocation for field data and assign fieldDataInfo to fieldData*/
   fieldData = (FieldData*)Lmalloc( sizeof(FieldData) *numExistFields);
   for( i=0; i < numExistFields; i++) {
     fieldData[i].id = filedDataInfo]i].id;
     fieldData[i].type = filedDataInfo]i].type;
     fieldData[i].len = filedDataInfo]i].len;
     if(fieldData[i].type==DBM_STRING || fieldData[i].type==DBM_BLOB )
       fieldData[i].content.str = Lmalloc(fieldData[i].len );
   }
   ret = as_DBMGetRecordAllFields( scanId, recId, fieldId, len, fieldDataType, content );
   ...
   for( i=0; i<numExistFields; i++) {
     if(fieldData[i].type==DBM_STRING || fieldData[i].type==DBM_BLOB )
       Lfree( fieldData[i].content.str );
   }
   ret=as_DBMGetPrevRecordId(scanId, &recId, &numExistFields, fieldDataInfo);
}

cf) as_DBMGetPrevRecordId(...) in case of as_ DBMOpenIndexScanTable(...)
   if( ret == DBM_OK_MATCH )
     //process for record matching with key value;
   if( ret == DBM_OK_UNMATCH)
     //process for record unmatching with key value;