Other Library Functions

function

vfMoveCursor

Library: omvfile - virtual file access and locking Include: omvfile.xin

Declaration

  define external function vfMoveCursor
         value omVFile vfile
      by value integer offset            optional
      to value integer absolute-position optional

Where:
this-vfile

the omVFile object where we want to change the cursor position

the cursor position will the current position plus the value specified by the offset value

the cursor position will be moved to the value specified by absolute-position value other possible values are VF-START, VF-END

You can use vfMoveCursor to move the cursor to a specified position. To do so, specify either the offset to move or the absolute value of the position to move to.

You will not be able to move the cursor position if the object has a source object (from a previous vfRead statement) or an output object (from a previous vfWrite statement).

Sample function call:

   vfMoveCursor vfile to vf-start

The above code moves the cursor to the start of the vfile. You can use the same call with VF-END to move the cursor to the end of the vfile.