Products Support Documentation Download
Cursor Association Functions (keyscan)
Collaboration diagram for Cursor Association Functions (keyscan):

Functions

RDM_RETCODE rdm_dbGetRowsByKey (RDM_DB db, RDM_KEY_ID keyId, RDM_CURSOR *pCursor)
 Associate an RDM_CURSOR with a row set based on a key. More...
 
RDM_RETCODE rdm_dbGetRowsByKeyAtKey (RDM_DB db, RDM_KEY_ID keyId, const void *keyValue, size_t len, RDM_CURSOR *pCursor)
 Associate an RDM_CURSOR with a row set that is ordered by key value and is initially positioned at the specified key value. More...
 
RDM_RETCODE rdm_dbGetRowsByKeyAtSearchKey (RDM_DB db, RDM_KEY_ID keyId, const RDM_SEARCH_KEY *keyValue, RDM_CURSOR *pCursor)
 Associate an RDM_CURSOR with a row set that is ordered by key value and is initially positioned at the specified key value. More...
 
RDM_RETCODE rdm_dbGetRowsByKeyInKeyRange (RDM_DB db, RDM_KEY_ID keyId, const void *startValue, size_t bytesInStartValue, const void *endValue, size_t bytesInEndValue, RDM_CURSOR *pCursor)
 Associate an RDM_CURSOR with rows in a specified key range. More...
 
RDM_RETCODE rdm_dbGetRowsByKeyInRangeKeyRange (RDM_DB db, RDM_KEY_ID keyId, const RDM_RANGE_KEY *startValue, const RDM_RANGE_KEY *endValue, RDM_CURSOR *pCursor)
 Associate an RDM_CURSOR with rows in a specified key range. More...
 
RDM_RETCODE rdm_dbGetRowsByKeyInRtreeKeyRange (RDM_DB db, RDM_KEY_ID keyId, const RDM_RTREE_KEY *keyValue, RDM_CURSOR *pCursor)
 Associate an RDM_CURSOR with a row set based on a r-tree. More...
 
RDM_RETCODE rdm_dbGetRowsByKeyInSearchKeyRange (RDM_DB db, RDM_KEY_ID keyId, const RDM_SEARCH_KEY *startValue, const RDM_SEARCH_KEY *endValue, RDM_CURSOR *pCursor)
 Associate an RDM_CURSOR with rows in a specified key range. More...
 

Detailed Description

Cursor association API for retrieving rows in key order. All the fuctions here are located in RDM DB Engine Library. Linker option:

    -lrdmrdm

See cursor for a more detailed description of a cursor.

Function Documentation

◆ rdm_dbGetRowsByKey()

RDM_RETCODE rdm_dbGetRowsByKey ( RDM_DB  db,
RDM_KEY_ID  keyId,
RDM_CURSOR pCursor 
)

#include <rdmdbapi.h>

Associate an RDM_CURSOR with a row set based on a key.

This function associates the RDM_CURSOR pointed to by pCursor with a row set ordered by the specified key. The row set will contain all of the rows for the table of the key specified. The RDM_CURSOR will be initially positioned in the BeforeFirst position.

Cursor Association Rules
  • If pCursor points to an RDM_CURSOR with a value of NULL then a new cursor will be allocated and associated with db.
  • If pCursor points to an RDM_CURSOR that has been allocated, it is associated with db but may not yet be associated with a set of rows.
  • If pCursor points to a RDM_CURSOR that is associated with an RDM_DB other than db then an error will be returned.
  • If pCursor points to a RDM_CURSOR that has been previously used and held a set of rows from a different table then memory may need to be reallocated to handle the new set of rows. If you are interacting with more than one set of tables it can be more efficient to use multiple RDM_CURSOR than to share a single RDM_CURSOR.
Locking Requirements
None.
Return values
sOKAYNormal, successful return.
eCURSORDBCursor is associated with a different database.
eDBNOTOPENDatabase not open.
eINVCURSORIDInvalid cursor id.
eINVKEYIDInvalid key id.
eISRTREEThe key specified is an rtree index.
ePRECOMMITTEDA precommitted transaction must be committed or rolled back before further operations on this database are allowed.
See also
rdm_dbStartRead
rdm_dbStartSnapshot
rdm_dbStartUpdate
rdm_dbGetRows
rdm_dbGetRowsAtRowId
rdm_dbGetRowsByKey
rdm_dbGetRowsByKeyAtKey
rdm_dbGetRowsByKeyAtSearchKey
rdm_dbGetRowsByKeyInKeyRange
rdm_cursorGetRowsByKeyAtPosition
rdm_cursorGetMemberRows
rdm_cursorGetOwnerRow
rdm_cursorGetRowsInReverseOrder
rdm_cursorGetSelf
rdm_cursorGetSiblingRows
rdm_cursorGetClone
rdm_cursorMoveToNext
rdm_cursorReadRow
rdm_cursorUpdateRow
rdm_cursorDeleteRow
rdm_cursorLinkRow
Parameters
[in]dbA valid RDM database handle
[in]keyIdThe RDM key id
[out]pCursorA pointer to an RDM_CURSOR (must be allocated, associated with db, or set to NULL)

◆ rdm_dbGetRowsByKeyAtKey()

RDM_RETCODE rdm_dbGetRowsByKeyAtKey ( RDM_DB  db,
RDM_KEY_ID  keyId,
const void *  keyValue,
size_t  len,
RDM_CURSOR pCursor 
)

#include <rdmdbapi.h>

Associate an RDM_CURSOR with a row set that is ordered by key value and is initially positioned at the specified key value.

This function associates a row set ordered by the specified key with the RDM_CURSOR pointed to by pCursor. The row set contains all of the rows for the table that the specified key is in.

The RDM_CURSOR will be initially positioned at the first row that matches the specified key value. If there is not an exact match then the RDM_CURSOR will be placed in the CURSOR_BETWEEN position. Navigating forward (rdm_cursorMoveToNext()) from that position will position the RDM_CURSOR at the next key value larger than the specified key value. Navigating backward (rdm_cursorMoveToPrevious()) from that position will position the RDM_CURSOR at the next key value smaller than the specified key value.

The engine validates the size of the buffers prior to accessing them.

  • If the size of the keyValue buffer is smaller than the size required to fully define the key then the remainder of the full buffer will be padded with NULL bytes and the search will be performed using that value.
  • If the size of the buffer is larger than the size required to fully the key then the extra bytes will be ignored and the search will be performed using the truncated value.
Cursor Association Rules
  • If pCursor points to an RDM_CURSOR with a value of NULL then a new cursor will be allocated and associated with db.
  • If pCursor points to an RDM_CURSOR that has been allocated, it is associated with db but may not yet be associated with a set of rows.
  • If pCursor points to a RDM_CURSOR that is associated with an RDM_DB other than db then an error will be returned.
  • If pCursor points to a RDM_CURSOR that has been previously used and held a set of rows from a different table then memory may need to be reallocated to handle the new set of rows. If you are interacting with more than one set of tables it can be more efficient to use multiple RDM_CURSOR than to share a single RDM_CURSOR.
Locking Requirements
Read lock on the table associated with keyId.
Return values
sOKAYNormal, successful return.
sNOTFOUNDRequested item not found. Success, but no exact key value match, the cursor position is set to CURSOR_BETWEEN.
eNOSTARTREADA read operation was attempted when no rdm_dbStartSnapshot(), rdm_dbStartRead(), or rdm_dbStartUpdate() is active.
eNOTLOCKEDAttempt to access a table for reading or update without proper locks.
eCURSORDBCursor is associated with a different database.
eDBNOTOPENDatabase not open.
eINVCURSORIDInvalid cursor id.
eINVKEYIDInvalid key id.
eISRTREEThe key specified is an rtree index.
ePRECOMMITTEDA precommitted transaction must be committed or rolled back before further operations on this database are allowed.
See also
rdm_dbStartRead
rdm_dbStartSnapshot
rdm_dbStartUpdate
rdm_dbGetRows
rdm_dbGetRowsAtRowId
rdm_dbGetRowsByKey
rdm_dbGetRowsByKeyAtKey
rdm_dbGetRowsByKeyAtSearchKey
rdm_dbGetRowsByKeyInKeyRange
rdm_cursorGetMemberRows
rdm_cursorGetOwnerRow
rdm_cursorGetRowsInReverseOrder
rdm_cursorGetSelf
rdm_cursorGetSiblingRows
rdm_cursorGetClone
rdm_cursorMoveToNext
rdm_cursorReadRow
rdm_cursorUpdateRow
rdm_cursorDeleteRow
rdm_cursorLinkRow
rdm-compile
Parameters
[in]dbA valid RDM database handle
[in]keyIdThe RDM key id
[in]keyValueThe key value used to position the cursor
[in]lenThe length of the key value buffer
[out]pCursorA pointer to an RDM_CURSOR (must be allocated, associated with db, or set to NULL)

◆ rdm_dbGetRowsByKeyAtSearchKey()

RDM_RETCODE rdm_dbGetRowsByKeyAtSearchKey ( RDM_DB  db,
RDM_KEY_ID  keyId,
const RDM_SEARCH_KEY keyValue,
RDM_CURSOR pCursor 
)

#include <rdmdbapi.h>

Associate an RDM_CURSOR with a row set that is ordered by key value and is initially positioned at the specified key value.

This function associates a row set ordered by the specified key with the RDM_CURSOR pointed to by pCursor. The row set contains all of the rows for the table that the specified key is in.

The RDM_CURSOR will be initially positioned at the first row that matches the specified key value. If there is not an exact match then the RDM_CURSOR will be placed in the CURSOR_BETWEEN position. Navigating forward (rdm_cursorMoveToNext()) from that position will position the RDM_CURSOR at the next key value larger than the specified key value. Navigating backward (rdm_cursorMoveToPrevious()) from that position will position the RDM_CURSOR at the next key value smaller than the specified key value.

The engine validates the size of the buffers prior to accessing them.

  • If the size of the keyValue buffer is smaller than the size required to fully define the key then the remainder of the full buffer will be padded with NULL bytes and the search will be performed using that value.
  • If the size of the buffer is larger than the size required to fully the key then the extra bytes will be ignored and the search will be performed using the truncated value.
Cursor Association Rules
  • If pCursor points to an RDM_CURSOR with a value of NULL then a new cursor will be allocated and associated with db.
  • If pCursor points to an RDM_CURSOR that has been allocated, it is associated with db but may not yet be associated with a set of rows.
  • If pCursor points to a RDM_CURSOR that is associated with an RDM_DB other than db then an error will be returned.
  • If pCursor points to a RDM_CURSOR that has been previously used and held a set of rows from a different table then memory may need to be reallocated to handle the new set of rows. If you are interacting with more than one set of tables it can be more efficient to use multiple RDM_CURSOR than to share a single RDM_CURSOR.
Locking Requirements
Read lock on the table associated with keyId.
Return values
sOKAYNormal, successful return.
sNOTFOUNDRequested item not found. Success, but no exact key value match, the cursor position is set to CURSOR_BETWEEN.
eNOSTARTREADA read operation was attempted when no rdm_dbStartSnapshot(), rdm_dbStartRead(), or rdm_dbStartUpdate() is active.
eNOTLOCKEDAttempt to access a table for reading or update without proper locks.
eCURSORDBCursor is associated with a different database.
eDBNOTOPENDatabase not open.
eINVCURSORIDInvalid cursor id.
eINVKEYIDInvalid key id.
eISRTREEThe key specified is an rtree index.
ePRECOMMITTEDA precommitted transaction must be committed or rolled back before further operations on this database are allowed.
See also
rdm_dbStartRead
rdm_dbStartSnapshot
rdm_dbStartUpdate
rdm_dbGetRows
rdm_dbGetRowsAtRowId
rdm_dbGetRowsByKeyAtSearchKey
rdm_dbGetRowsByKeyInKeyRange
rdm_dbGetRowsByKeyInRangeKeyRange
rdm_dbGetRowsByKeyInRtreeKeyRange
rdm_dbGetRowsByKeyInSearchKeyRange
rdm_cursorGetMemberRows
rdm_cursorGetOwnerRow
rdm_cursorGetRowsInReverseOrder
rdm_cursorGetSelf
rdm_cursorGetSiblingRows
rdm_cursorGetClone
rdm_cursorMoveToNext
rdm_cursorReadRow
rdm_cursorUpdateRow
rdm_cursorDeleteRow
rdm_cursorLinkRow
Parameters
[in]dbA valid RDM database handle
[in]keyIdThe RDM key id
[in]keyValueThe key value used to position the cursor
[out]pCursorA pointer to an RDM_CURSOR (must be allocated, associated with db, or set to NULL)

◆ rdm_dbGetRowsByKeyInKeyRange()

RDM_RETCODE rdm_dbGetRowsByKeyInKeyRange ( RDM_DB  db,
RDM_KEY_ID  keyId,
const void *  startValue,
size_t  bytesInStartValue,
const void *  endValue,
size_t  bytesInEndValue,
RDM_CURSOR pCursor 
)

#include <rdmdbapi.h>

Associate an RDM_CURSOR with rows in a specified key range.

This function associates the RDM_CURSOR pointed to by pCursor with a row set ordered by the specified key. The row set contains all of the rows for the table that have a key value that is in the range specified by the start and end values. If the specified start value is NULL then the start of the range will be the first index value. If the end value is NULL then the end of the range will be the last index value. Specifying a start value of NULL and an end value of NULL is equivalent to rdm_dbGetRowsByKey().

For a key that allows duplicate values it can be useful to specify the same value for the start and the end range. For example, the foreign side of a primary foreign key relationship can be retrieved by specifying the primary key value as the start and end value of a key on the foreign table that references the primary key of the primary table. If the index is unique then specifying the same start and end value will result in at most one row in the cursor collection.

The cursor will be initially positioned to the BeforeFirst location.

The engine checks the size of buffers prior to accessing them.

  • If the value of bytesInStartValue or bytesInEnd is zero, the size of startValue or endValue is assumed to be large enough to fully define the key.
  • If the value of bytesInStartValue or bytesInEnd is non-zero, the value must be large enough to fully define the key. Otherwise, an error is returned.
  • If the size of the buffer is larger than the size required to fully the key then the extra bytes will be ignored and the search will be performed using the truncated value.
Cursor Association Rules
  • If pCursor points to an RDM_CURSOR with a value of NULL then a new cursor will be allocated and associated with db.
  • If pCursor points to an RDM_CURSOR that has been allocated, it is associated with db but may not yet be associated with a set of rows.
  • If pCursor points to a RDM_CURSOR that is associated with an RDM_DB other than db then an error will be returned.
  • If pCursor points to a RDM_CURSOR that has been previously used and held a set of rows from a different table then memory may need to be reallocated to handle the new set of rows. If you are interacting with more than one set of tables it can be more efficient to use multiple RDM_CURSOR than to share a single RDM_CURSOR.
Locking Requirements
None.
Return values
sOKAYNormal, successful return.
sNOTFOUNDRequested item not found. Success, but no exact key value match, the cursor position is set to CURSOR_BETWEEN.
eCURSORDBCursor is associated with a different database.
eDBNOTOPENDatabase not open.
eINVCURSORIDInvalid cursor id.
eINVKEYIDInvalid key id.
eISRTREEThe key specified is an rtree index.
ePRECOMMITTEDA precommitted transaction must be committed or rolled back before further operations on this database are allowed.
See also
rdm_dbStartRead
rdm_dbStartSnapshot
rdm_dbStartUpdate
rdm_dbGetRows
rdm_dbGetRowsAtRowId
rdm_dbGetRowsByKey
rdm_dbGetRowsByKeyAtSearchKey
rdm_dbGetRowsByKeyInRangeKeyRange
rdm_dbGetRowsByKeyInRtreeKeyRange
rdm_dbGetRowsByKeyInSearchKeyRange
rdm_cursorGetMemberRows
rdm_cursorGetOwnerRow
rdm_cursorGetRowsInReverseOrder
rdm_cursorGetSelf
rdm_cursorGetSiblingRows
rdm_cursorGetClone
rdm_cursorMoveToNext
rdm_cursorReadRow
rdm_cursorUpdateRow
rdm_cursorDeleteRow
rdm_cursorLinkRow
rdm-compile
Parameters
[in]dbA valid RDM database handle
[in]keyIdThe RDM key id
[in]startValueThe value for the start of the range
[in]bytesInStartValuethe size of startValue in bytes
[in]endValueThe value for the end of the range
[in]bytesInEndValuethe size of endValue in bytes
[out]pCursorA pointer to an RDM_CURSOR (must be allocated, associated with db, or set to NULL)

◆ rdm_dbGetRowsByKeyInRangeKeyRange()

RDM_RETCODE rdm_dbGetRowsByKeyInRangeKeyRange ( RDM_DB  db,
RDM_KEY_ID  keyId,
const RDM_RANGE_KEY startValue,
const RDM_RANGE_KEY endValue,
RDM_CURSOR pCursor 
)

#include <rdmdbapi.h>

Associate an RDM_CURSOR with rows in a specified key range.

This function associates the RDM_CURSOR pointed to by pCursor with a row set ordered by the specified key. The row set contains all of the rows for the table that have a key value that is in the range specified by the start and end values. If the specified start value is NULL then the start of the range will be the first index value stored in the database. If the end value is NULL then the end of the range will be the last index value stored in the database. Specifying a start value of NULL and an end value of NULL is equivalent to rdm_dbGetRowsByKey().

For a key that allows duplicate values it can be useful to specify the same value for the start and the end range. For example, the foreign side of a primary foreign key relationship can be retrieved by specifying the primary key value as the start and end value of a key on the foreign table that references the primary key of the primary table. If the index is unique then specifying the same start and end value will result in at most one row in the cursor collection.

The range can either be 'inclusive' or 'exclusive'. If the range field in the RDM_RANGE_KEY is set to RDM_RANGE_OPEN keys that match the value will be included in the result set. If the range field in RDM_RANGE_KEY is RDM_RANGE_CLOSED then keys that match the value will not be included in the result set.

The cursor will be initially positioned to the BeforeFirst location.

Cursor Association Rules
  • If pCursor points to an RDM_CURSOR with a value of NULL then a new cursor will be allocated and associated with db.
  • If pCursor points to an RDM_CURSOR that has been allocated, it is associated with db but may not yet be associated with a set of rows.
  • If pCursor points to a RDM_CURSOR that is associated with an RDM_DB other than db then an error will be returned.
  • If pCursor points to a RDM_CURSOR that has been previously used and held a set of rows from a different table then memory may need to be reallocated to handle the new set of rows. If you are interacting with more than one set of tables it can be more efficient to use multiple RDM_CURSOR than to share a single RDM_CURSOR.
Locking Requirements
None.
Return values
sOKAYNormal, successful return.
sNOTFOUNDRequested item not found. Success, but no exact key value match, the cursor position is set to CURSOR_BETWEEN.
eCURSORDBCursor is associated with a different database.
eDBNOTOPENDatabase not open.
eINVCURSORIDInvalid cursor id.
eINVKEYIDInvalid key id.
eISRTREEThe key specified is an rtree index.
ePRECOMMITTEDA precommitted transaction must be committed or rolled back before further operations on this database are allowed.
See also
rdm_dbStartRead
rdm_dbStartSnapshot
rdm_dbStartUpdate
rdm_dbGetRows
rdm_dbGetRowsAtRowId
rdm_dbGetRowsByKey
rdm_dbGetRowsByKeyInKeyRange
rdm_dbGetRowsByKeyInRtreeKeyRange
rdm_dbGetRowsByKeyInSearchKeyRange
rdm_cursorGetMemberRows
rdm_cursorGetOwnerRow
rdm_cursorGetRowsInReverseOrder
rdm_cursorGetSelf
rdm_cursorGetSiblingRows
rdm_cursorGetClone
rdm_cursorMoveToNext
rdm_cursorReadRow
rdm_cursorUpdateRow
rdm_cursorDeleteRow
rdm_cursorLinkRow
Parameters
[in]dbA valid RDM database handle
[in]keyIdThe RDM key id
[in]startValueThe value for the start of the range
[in]endValueThe value for the end of the range
[out]pCursorA pointer to an RDM_CURSOR (must be allocated, associated with db, or set to NULL)

◆ rdm_dbGetRowsByKeyInRtreeKeyRange()

RDM_RETCODE rdm_dbGetRowsByKeyInRtreeKeyRange ( RDM_DB  db,
RDM_KEY_ID  keyId,
const RDM_RTREE_KEY keyValue,
RDM_CURSOR pCursor 
)

#include <rdmdbapi.h>

Associate an RDM_CURSOR with a row set based on a r-tree.

This function associates the RDM_CURSOR pointed to by pCursor with a row set based on the the specified rtree index. The row set will contain all of the rows for the table of the key specified that match the search criteria. The RDM_CURSOR will be initially positioned in the BeforeFirst position.

Cursor Association Rules
  • If pCursor points to an RDM_CURSOR with a value of NULL then a new cursor will be allocated and associated with db.
  • If pCursor points to an RDM_CURSOR that has been allocated, it is associated with db but may not yet be associated with a set of rows.
  • If pCursor points to a RDM_CURSOR that is associated with an RDM_DB other than db then an error will be returned.
  • If pCursor points to a RDM_CURSOR that has been previously used and held a set of rows from a different table then memory may need to be reallocated to handle the new set of rows. If you are interacting with more than one set of tables it can be more efficient to use multiple RDM_CURSOR than to share a single RDM_CURSOR.
Locking Requirements
None.
Return values
sOKAYNormal, successful return.
sNOTFOUNDRequested item not found. Success, but no exact key value match, the cursor position is set to CURSOR_BETWEEN.
eCURSORDBCursor is associated with a different database.
eDBNOTOPENDatabase not open.
eINVCURSORIDInvalid cursor id.
eINVKEYIDInvalid key id.
eNOTRTREEThe key specified is not an rtree index.
ePRECOMMITTEDA precommitted transaction must be committed or rolled back before further operations on this database are allowed.
See also
rdm_dbStartRead
rdm_dbStartSnapshot
rdm_dbStartUpdate
rdm_dbGetRows
rdm_dbGetRowsAtRowId
rdm_dbGetRowsByKey
rdm_dbGetRowsByKeyInKeyRange
rdm_dbGetRowsByKeyInRangeKeyRange
rdm_dbGetRowsByKeyInSearchKeyRange
rdm_cursorGetMemberRows
rdm_cursorGetOwnerRow
rdm_cursorGetRowsInReverseOrder
rdm_cursorGetSelf
rdm_cursorGetSiblingRows
rdm_cursorGetClone
rdm_cursorMoveToNext
rdm_cursorReadRow
rdm_cursorUpdateRow
rdm_cursorDeleteRow
rdm_cursorLinkRow
Parameters
[in]dbA valid RDM database handle
[in]keyIdThe RDM key id
[in]keyValueThe key value used to position the cursor
[out]pCursorA pointer to an RDM_CURSOR (must be allocated, associated with db, or set to NULL)

◆ rdm_dbGetRowsByKeyInSearchKeyRange()

RDM_RETCODE rdm_dbGetRowsByKeyInSearchKeyRange ( RDM_DB  db,
RDM_KEY_ID  keyId,
const RDM_SEARCH_KEY startValue,
const RDM_SEARCH_KEY endValue,
RDM_CURSOR pCursor 
)

#include <rdmdbapi.h>

Associate an RDM_CURSOR with rows in a specified key range.

This function associates the RDM_CURSOR pointed to by pCursor with a row set ordered by the specified key. The row set contains all of the rows for the table that have a key value that is in the range specified by the start and end values. If the specified start value is NULL then the start of the range will be the first index value. If the end value is NULL then the end of the range will be the last index value. Specifying a start value of NULL and an end value of NULL is equivalent to rdm_dbGetRowsByKey().

For a key that allows duplicate values it can be useful to specify the same value for the start and the end range. For example, the foreign side of a primary foreign key relationship can be retrieved by specifying the primary key value as the start and end value of a key on the foreign table that references the primary key of the primary table. If the index is unique then specifying the same start and end value will result in at most one row in the cursor collection.

The cursor will be initially positioned to the BeforeFirst location.

The engine validates the size of buffers prior to accessing them.

  • If the size of the startValue or endValue buffer is smaller than the size required to fully define the key then the remainder of the full buffer will be padded with NULL bytes and the search will be performed using that value.
  • If the size of the buffer is larger than the size required to fully the key then the extra bytes will be ignored and the search will be performed using the truncated value.
Cursor Association Rules
  • If pCursor points to an RDM_CURSOR with a value of NULL then a new cursor will be allocated and associated with db.
  • If pCursor points to an RDM_CURSOR that has been allocated, it is associated with db but may not yet be associated with a set of rows.
  • If pCursor points to a RDM_CURSOR that is associated with an RDM_DB other than db then an error will be returned.
  • If pCursor points to a RDM_CURSOR that has been previously used and held a set of rows from a different table then memory may need to be reallocated to handle the new set of rows. If you are interacting with more than one set of tables it can be more efficient to use multiple RDM_CURSOR than to share a single RDM_CURSOR.
Locking Requirements
None.
Return values
sOKAYNormal, successful return.
sNOTFOUNDRequested item not found. Success, but no exact key value match, the cursor position is set to CURSOR_BETWEEN.
eCURSORDBCursor is associated with a different database.
eDBNOTOPENDatabase not open.
eINVCURSORIDInvalid cursor id.
eINVKEYIDInvalid key id.
eISRTREEThe key specified is an rtree index.
ePRECOMMITTEDA precommitted transaction must be committed or rolled back before further operations on this database are allowed.
See also
rdm_dbStartRead
rdm_dbStartSnapshot
rdm_dbStartUpdate
rdm_dbGetRows
rdm_dbGetRowsAtRowId
rdm_dbGetRowsByKeyAtSearchKey
rdm_dbGetRowsByKeyInKeyRange
rdm_dbGetRowsByKeyInRangeKeyRange
rdm_dbGetRowsByKeyInRtreeKeyRange
rdm_cursorGetMemberRows
rdm_cursorGetOwnerRow
rdm_cursorGetRowsInReverseOrder
rdm_cursorGetSelf
rdm_cursorGetSiblingRows
rdm_cursorGetClone
rdm_cursorMoveToNext
rdm_cursorReadRow
rdm_cursorUpdateRow
rdm_cursorDeleteRow
rdm_cursorLinkRow
Parameters
[in]dbA valid RDM database handle
[in]keyIdThe RDM key id
[in]startValueThe value for the start of the range
[in]endValueThe value for the end of the range
[out]pCursorA pointer to an RDM_CURSOR (must be allocated, associated with db, or set to NULL)