Library /sys$common/syshlp/helplib.hlb  —  DECdts  utc_multime
    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
Close Help