FairCom Direct SQL for C and C++

ctsqlJumpTo

Retrieve the nth row from cursor current position.

Declaration

CTSQLRET ctsqlJumpTo(pCTSQLCURSOR hCursor, INTEGER nth)

Description

• hCursor - the cursor handle
• nth - the nth item to retrieve relative to the current position

Returns the nth row from the current position. It jumps backward when nth is a negative value or forward for a positive nth value.

Return Values

CTSQLRET_OK on success.

See c-tree Plus Error Codes for a complete listing of valid c-tree Plus error values.

Example

ctsqlJumpTo(hCursor, 1) is the same as calling ctsqlNext().

ctsqlJumpTo(hCursor, -1) is the same as calling ctsqlPrev().