Cursor Association Functions (other)
Collaboration diagram for Cursor Association Functions (other):

Functions

RDM_RETCODE rdm_rdmGetAfterLast (RDM_CURSOR *pCursor)
Get the special AfterLast cursor. More...
RDM_RETCODE rdm_rdmGetBeforeFirst (RDM_CURSOR *pCursor)
Get the special BeforeFirst cursor. More...

Detailed Description

The core cursor association for the special \e BeforeFirst and
\e AfterLast position.  The functions here are located in
\ref lib_rdm. Linker option:\
 <pre><code>    -l<tt><a href="lib_rdm.html">rdmrdm</a></tt></code></pre>

Function Documentation

rdm_rdmGetAfterLast()

RDM_RETCODE rdm_rdmGetAfterLast ( RDM_CURSOR * pCursor )

#include <rdmrdmapi.h>

Get the special AfterLast cursor.

This function assigns pCursor to the special AfterLast cursor. The AfterLast cursor can be used as the second argument to rdm_cursorComparePosition(). The cursor is positioned to the AfterLast position and cannot be changed.

The special cursors are static and cannot be freed. The pCursor parameter should not point to an allocated (or associated) RDM_CURSOR as you would lose its reference.

Locking Requirements
None
Return values
sOKAY Normal, successful return.
See also
rdm_cursorComparePosition
Parameters
[out] pCursor [out] A pointer to an RDM_CURSOR (this should not point to an allocated or associated cursor)

rdm_rdmGetBeforeFirst()

RDM_RETCODE rdm_rdmGetBeforeFirst ( RDM_CURSOR * pCursor )

#include <rdmrdmapi.h>

Get the special BeforeFirst cursor.

This function assigns pCursor to the special BeforeFirst cursor. The BeforeFirst cursor can be used as the second argument to rdm_cursorComparePosition(). The cursor is positioned to the BeforeFirst position and cannot be changed.

The special cursors are static and cannot be freed. The pCursor parameter should not point to an allocated (or associated) RDM_CURSOR as you would lose its reference.

Locking Requirements
None
Return values
sOKAY Normal, successful return.
Parameters
[out] pCursor [out] A pointer to an RDM_CURSOR (this should not point to an allocated or associated cursor)