Multiplies a relative binary timestamp by an integer factor.

    Format

      #include <utc.h>

      int utc_multime(*result, *utc1, factor)

         utc_t *result;
         const utc_t *utc1;
         long factor;

1 - Parameters

    Input

 utc1

    Relative binary timestamp.

 factor

    Integer scale factor.

    Output

 result

    Resulting relative binary timestamp.

2 - Description

    The Multiply Relative Time by an Integer Factor routine
    multiplies a relative binary timestamp by an integer. Either
    or both may be negative; the resulting binary timestamp has the
    appropriate sign. The unsigned inaccuracy in the binary timestamp
    is also multiplied by the absolute value of the integer.

3 - Returns

     0   Indicates that the routine executed successfully.
    -1   Indicates an invalid time argument or invalid results.

4 - Example

    See the sample program for the utc_mulftime routine.

5 - Related Functions

    utc_mulftime