KI_READ_PTR

Re-read a row using its row ID

Synopsis:
CALL KI_READ_PTR handle, rowid$, SYM(rowbuf$), [eLockType] TO status, [bRefresh]
'ki_read_ptr( handle, rowid$, SYM(rowbuf$), [eLockType], [bRefresh] )
ArgumentEnumerationPurpose
handleHandle
rowid$Row ID from a previous read
SYM(rowbuf$)Symbol of data buffer
eLockTypeKCML_KDB_LOCK_ENUMOptional lock type
statusKDB_ERROR_ENUMReturn status
bRefreshTRUE iff row was refreshed
>KI_READ_PTR

KI_READ_PTR

Reads a row with the specified ROWID directly into the row buffer. This is fast as it does not use any index. If the ROWID is invalid or if the row has been deleted then error code KE_NOTFOUND will be returned.

By supplying the eLockTYpe optional argument this function can subsume the functionality of KI_READ_HOLD_PTR and take a transactional or long term lock on a row.

History
Introduced in KCML 3.00
See Also:
KI_BUILD, KI_COPY_TABLE, KI_CREATE, KI_CREATE_TMP, KI_DELETE, KI_DELETE_ROWS, KI_DELETE_WHERE, KI_END, KI_ERROR, KI_ERROR_TEXT, KI_FETCH, KI_GET_ERROR_TEXT, KI_GET_SERIAL, KI_GROW, KI_INFO, KI_INITIALISE, KI_LOCK_ALL, KI_LOCK_OWNER, KI_MOVE_ROWS, KI_MOVE_TABLE, KI_OPEN, KI_READ, KI_READ_ARRAY, KI_READ_HOLD, KI_READ_HOLD_NEXT, KI_READ_HOLD_PTR, KI_READ_NEXT, KI_READ_RANDOM, KI_READ_RAW, KI_REBUILD, KI_REWRITE, KI_SET_EXTENT, KI_SET_ROWS, KI_SET_SERIAL, KI_SET_WLOCK_COUNT, KI_SIZE_FILE, KI_START, KI_START_BEG, KI_START_BETWEEN, KI_START_FIRST, KI_START_ON, KI_START_ROW, KI_START_ROW_BETWEEN, KI_UNLOCK, KI_UNLOCK_FILE, KI_VERIFY, KI_WMODE_BITMAP, KI_WRITE, KI_WRITE_PTR, KI_WRITE_RAW, KI_WS_CREATE, KI_WS_DELETE, KI_WS_OPEN, KI_WS_READ, KI_WS_REWRITE, KI_WS_WRITE
KCML database status codes