utc_abstime(3dts)

Synopsis

#include <dce/utc.h>

int utc_abstime(
utc_t* result,
utc_t *utc);

Parameters

Input

utc
Relative binary timestamp. Use NULL if you want this routine to use the current time for this parameter.

Output

result
Absolute value of the input relative binary timestamp.

Description
The utc_abstime( ) routine computes the absolute value of a relative binary timestamp. The input timestamp represents a relative (delta) time.

Return Values
~0 Indicates that the routine executed successfully.

1 Indicates an invalid time parameter or invalid results.

Examples
The following example scales a relative time, computes its absolute value, and prints the result.

utc_t relutc, scaledutc;
char timstr[UTC_MAX_STR_LEN];

/*
* Make sure relative timestamp represents a positive interval...
*/
utc_abstime(&relutc, /* Out: Abs-value of rel time */

&relutc); /* In: Relative time to scale */

/*
* Scale it by a factor of 17...
*/
utc_multime(&scaledutc, /* Out: Scaled relative time */
&relutc, /* In: Relative time to scale */
17L); /* In: Scale factor */
utc_ascreltime(timstr, /* Out: ASCII relative time */
UTC_MAX_STR_LEN, /* In: Length of input string */
&scaledutc); /* In: Relative time to */
/* convert */

printf("%s\n",timstr);

/*
* Scale it by a factor of 17.65...
*/
utc_mulftime(&scaledutc, /* Out: Scaled relative time */
&relutc, /* In: Relative time to scale */
17.65); /* In: Scale factor */
utc_ascreltime(timstr, /* Out: ASCII relative time */
UTC_MAX_STR_LEN, /* In: Length of input string */
&scaledutc); /* In: Relative time to */
/* convert */
printf("%s\n",timstr);