as_DBMGetNextRecordIdWithFlag

as_DBMGetNextRecordIdWithFlag

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

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

See Also
as_DBMGetNextRecordId

Example
TableId tableId;
ScanId scanId;
RecId recId;
DBMErr ret=DBM_OK;
S32 numFields, numExistFields; FieldDataInfo *fieldDataInfo;
FieldData fieldData;
unsigned char status;
// 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_DBMGetNextRecordIdWithFlag( scanId, &recId, &numExistFields,
fieldDataInfo, &status)
while(ret >= DBM_OK ) {    /*memory allocation for field data and assign fieldDataInfo to fieldData*/

   ret = as_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=as_DBMGetNextRecordIdWithFlag(scanId,&recId,&numExistFields, fieldDataInfo, &status)
}