VMS Help DCE_DTS, Application Routines, utc_multime  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME

   utc_multime - Multiplies a relative binary timestamp by an integer
                 factor

 SYNOPSIS

   #include <dce/utc.h>

   int utc_multime( utc_t *result,
                    utc_t *utc1,
                    long factor );

 PARAMETERS

   Input

   utc1
       Relative binary timestamp.

   factor
       Integer scale factor.

   Output

   result
       Resulting relative binary timestamp.

 DESCRIPTION

   The utc_multime() 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.

 RETURN VALUES

    0    Indicates that the routine executed successfully.

   -1    Indicates an invalid time argument or invalid results.

 EXAMPLES

   The following example scales a relative time by an integral value
   and prints the result.

        utc_t       relutc, scaledutc;
        char        timstr[UTC_MAX_STR_LEN];

        /*   Assume relutc contains the time to scale. Scale it by a
         *   factor of 17 ...
         */
        utc_multime(&scaledutc,     /* Out: Scaled rel time       */
                       &relutc,     /*  In: Rel time to scale     */
                           17L);    /*  In: Scale factor          */

        utc_ascreltime(timstr,      /* Out: ASCII rel time        */
              UTC_MAX_STR_LEN,      /*  In: Input buffer length   */
                   &scakedutc);     /*  In: Rel time to convert   */

        printf("Scaled result is %s0, timstr);

 RELATED INFORMATION

   Functions: utc_mulftime