Products Support Documentation Download
Collaboration diagram for RDM Cursor APIs:

Modules

 Cursor Cleanup Functions
 
 Cursor Information Functions
 
 Cursor Association Functions (rowscan)
 
 Cursor Association Functions (keyscan)
 
 Cursor Association Functions (setscan)
 
 Cursor Association Functions (other)
 
 Cursor Navigation Functions
 
 Read Functions
 
 Update Functions
 
 Delete Functions
 
 Set Functions
 
 Cursor Comparison Functions
 
 Miscellaneous functions
 

Detailed Description

The core database API for handling and navigating data. All the functions here are located in RDM DB Engine Library. Linker option:

    -lrdmrdm

A cursor represent a set of rows from a table ordered by certain criteria. Except where we have set relationships (Set Functions) or the special cursor returned by rdm_rdmGetBeforeFirst() or rdm_rdmGetAfterLast() a cursor always represent all rows for a given table.

When a cursor is associated with a set of rows, the cursor will be positioned at the BeforeFirst position or where applicable it will be positioned at a given row or position. Use Cursor Navigation Functions to navigate forward, backward, or to a given position. A position can be at any row in the set, between rows, or the BeforeFirst or AfterLast positions. Use Cursor Comparison Functions to comapre the position of two cursors.

The simplest cursors are singletons returned by rdm_rdmGetBeforeFirst(), rdm_rdmGetAfterLast(), rdm_cursorGetSelf(), rdm_cursorGetOwnerRow(). All other cursors are associated with zero or more rows from a given table.