as_DBMOpenSeqScanTableWithCursor

as_DBMOpenSeqScanTableWithCursor

Description
GetOffset으로부터 얻어진 레코드 위치에서부터 특정 테이블에 속하는 레코드들을 primary/secondary key 순서로 읽기 위한 스캔 관리자를 초기화한다

Syntax
DBMErr as_DBMOpenSeqScanTableWithCursor(TableId tableId, IndexFlag indexFlag, RecId recId, RecOrder recOrder, ScanId* scanId);

Parameters

tableId	테이블의 ID
indexFlag	primary key 필드와 secondary key 필드 중 논리적 순서의 기준이 되는 필드를 선택하는 플래그 DBM_PRIM : primary key 필드 DBM_SEC : secondary key 필드
recId	GetOffset을 수행한 recId와 동일한 값
recOrderFlag	레코드의 검색 순서 DBM_INCR : increasing order DBM_DECR : decreasing order
scanId	open된 스캔 ID

Returns

value	설명
DBM_OK	성공적으로 수행된 경우
DBM_TOO_MANY_SCANS	이미 open된 스캔의 수가 NUM_SCANS인 경우
DBM_INVALID_TABLE_ID	주어진 테이블 id를 갖는 테이블이 존재하지 않는 경우
DBM_INVALID_FLAG	indexFlag가 DBM_PRIM도 DBM_SEC도 아닌 경우
DBM_INVALID_RECID	GetOffset을 수행한 recId와 다른 경우
DBM_OPEN_SCAN_ERR	recOrder가 DBM_INCR나 DBM_DECR이 아닌 경우
DBM_SECONDARY_INDEX_NOT_EXIST	테이블에 secondary index가 없는데도 indexFlag가 DBM_SEC인 경우
DBM_DB_NOT_INITED	데이타베이스가 초기화되어 있지 않은 경우

Comments
항상 as_DBMGetOffset API를 호출한 후, 이 함수를 호출해야 한다.
as_DBMGetOffset을 한 후에 레코드의 추가/삭제/수정 등의 작업을 하고 이 API를 이용하는 경우, 잘못된 결과를 가져올 수 있다.

as_DBMGetOffset, as_DBMOpenSeqScanTable 함수에서 스캔을 오픈하고 레코드에 대해 빠른 접근을 지원하기 위해 사용.

See Also
as_DBMGetOffset, as_DBMGetNextRecordId, as_DBMGetPrevRecordId,
as_DBMOpenSeqScanCategory, as_DBMOpenSeqScanTableWithCursor

Example
TableId tableId; ScanId scanId;
RecId recId; DBMErr ret=DBM_OK;
int numFields, numExistFields; FieldDataInfo fieldDataInfo;
FieldData keyData, fieldData;
IndexFlag indexFlag = DBM_PRIM;
int offset = 10;
RecOrder recOrder=DBM_INCR;

// Get tableId, catId
ret = as_DBMOpenSeqScanTableWithCursor( tableId, indexFlag, offset, recOrder, &scanId);
if( ret < DBM_OK ) // error handling

numFields = NUM_FIELDS;
...
/* allocate space for fieldDataInfo */
fieldDataInfo =(FieldDataInfo*)Lmalloc( sizeof(FieldDataInfo) * numFields );
while( (ret = as_DBMGetNextRecordId( scanId, &recId, &numExistFields, fieldDataInfo) >= DBM_OK ) {
...
}