NAME
          irLSeek - move read/write pointer in voice file

     SYNOPSIS
          #include <irapi.h> #include <unistd.h>

          long irLSeek (vf_descriptor vfd, long offset, int whence);

     DESCRIPTION
          The irLSeek function allows positional access to a voice
          file referenced by an open voice file descriptor (vfd).  If
          vfd is a voice file, irLSeek will seek by millisecond.  If
          vfd is a text file, irLSeek will seek by character.  A vfd
          is obtained by first calling irOpen(3IRAPI).  This function
          is similar to lseek(2).

          If whence is SEEK_SET, the pointer is set to offset.

          If whence is SEEK_CUR, the pointer is set to its current
          location plus the offset.

          If whence is SEEK_END, the pointer is set to the length of
          the voice file plus the offset.

          This function may be used to return the current position by
          setting whence to SEEK_CUR, and offset to 0.

          Note: If a call to irLSeek results in a negative file
          pointer, irLSeek sets the file pointer to 0.

     EVENT
          No event results from the call to irLSeek.

     RETURN VALUE
          This function returns a non-negative long indicating the
          voice file pointer location in milliseconds for voice files
          and characters for text files.

          IRR_FAIL is returned if an error occurs.

     ERROR
          irError is set as follows if an error occurs:

          IRER_INVALID if vfd is not an open voice file descriptor or
          whence is not SEEK_SET, SEEK_CUR, or SEEK_END

     SEE ALSO
          lseek(2), irGetVCount(3IRAPI), irTruncate(3IRAPI)

     VERSION
          This is version 8/31/00 of this man page.