NAME
          irByte2Time - convert byte to time

     SYNOPSIS
          #include <irapi.h>

          long irByte2Time (int algorithm, long byte);

     DESCRIPTION
          The irByte2Time function returns the time equivalence in
          milliseconds of a specified number of bytes for a given
          algorithm. See IrALGORITHMS(4IRAPI) for the values of algo-
          rithm.

          This function may be used by an application to convert a
          position in a voice file to time.

     EVENT
          No event results from the call to irByte2Time.

     RETURN VALUE
          Time is returned in milliseconds if the request is success-
          ful.

          0 is returned if an error occurs.

     ERROR
          irError is set to IRER_INVALID if an invalid value for algo-
          rithm is passed.

     EXAMPLE
          When a touch tone interrupts playback, a call to
          irCheck(3IRAPI) obtains an event structure that contains the
          event identifier (for example, IRE_INPUT).  The application
          then calls irGetVCount(3IRAPI) which returns the byte-count
          from the point where the voice pointer was reset [see
          irGetVCount(3IRAPI)].  The irByte2Time function converts
          this byte count to time.  The application can perform arith-
          metic on the time, for example to "rewind" five seconds, and
          convert this new time to a byte count with
          irTime2Byte(3IRAPI).

     CAVEATS
          Silence compression is not supported.  Text-to-Speech (TTS)
          byte to time conversion is not supported.

     SEE ALSO
          IrALGORITHMS(4IRAPI), irTime2Byte(3IRAPI),
          irGetVCount(3IRAPI)

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