Goto: 4C Home | 4C Docs | System PCLs List sys.set_skey()

sys.set_skey()

Purpose:
sys.set_skey() sets the start position for sequential reads.
Usage:
ret = sys.set_skey(<asfile>,<fldcdef>,<matchtype>);
Arguments:

asfile - <asfile> - The asfile name of the file you are setting the start key pos for.

integer <fldcdef> - The cdef of the fld you want to seek to.

integer <matchflag> - Either MATCH_FULL or MATCH_PARTIAL
Returns:
0 - Start Pos Set OK
-1 - Some Error
Where Used:
sys.set_skey() will typically be called before reading a file sequentially.
Example:
See the demo.seekkey.1 demo program for an example.
Description:
sys.set_skey() sets the starting position for sequential reading of a file. It is typically used along with sys.set_ekey(), and sys.seek_key() before calling sys.read_file(...,F_SEQNEXT). Before calling sys.set_skey() set values into the fields that need them.
Bugs/Features/Comments:
See Also:
sys.set_ekey()
sys.seek_key()
sys.read_file()


Back to Top