DBMOpenSeqScanCategoryWithCursor

DBMOpenSeqScanCategoryWithCursor

Description
이전에 호출된 DBMGetOffset 함수의 레코드로부터 얻어진 위치에서 시작하는 특정 Category에 속하는 레코드들을 읽기 위한 스캔 관리자를 초기화한다.

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

Parameters

tableId	테이블의 ID
catId	Category 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_CAT_ID	주어진 Category id를 갖는 Category가 존재하지 않는 경우
DBM_DB_NOT_INITED	데이타베이스가 초기화되어 있지 않은 경우
DBM_INVALID_RECID	GetOffset을 수행한 recId와 다른 경우
DBM_SECONDARY_INDEX_NOT_EXIST	테이블에 secondary index가 없는데도 indexFlag가 DBM_SEC인 경우

Comments
항상 DBMGetOffset API를 호출한 후, 이 함수를 호출해야 한다.

DBMGetOffset을 한 후에 레코드의 추가/삭제/수정 등의 작업을 하고 이 API를 이용하는 경우, 잘못된 결과를 가져올 수 있다.
DBMGetOffset, DBMOpenSeqScanCategory 함수에서 스캔을 오픈하고 레코드에 대해 빠른 접근을 지원하기 위해 사용.

See Also
DBMGetOffset, DBMOpenSeqScanTableWithCursor, DBMGetNextRecordId

Example

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

  // Get tableId, catId
  // Get record Id
  ret = DBMGetOffset( tableId, catId, indexFlag, recId, recOrder, &offset );
  if( ret < DBM_OK )
     // error handling
  ret = DBMOpenSeqScanCategoryWithCursor( tableId, catId, indexFlag, recId, recOrder, &scanId);
  if( ret < DBM_OK ) // error handling
  numFields = NUM_FIELDS;
  /* allocate space for fieldDataInfo */
  fieldDataInfo =(FieldDataInfo*)Lmalloc( sizeof(FieldDataInfo) * numFields );
  while( (ret = DBMGetNextRecordId( scanId, &recId, &numExistFields, fieldDataInfo) >= DBM_OK ) {
     ...
  }