Converts a relative binary timestamp to two timespec structures
that express relative time and inaccuracy.
Format
#include <utc.h>
int utc_binreltime(*timesp, *inaccsp, *utc)
reltimespec_t *timesp;
timespec_t *inaccsp;
const utc_t *utc;
1 – Parameters
Input
utc
Relative binary timestamp.
Output
timesp
Time component of the relative binary timestamp, in the form
of seconds and nanoseconds since the base time (1970-01-
01:00:00:00.0 + 00:00I0).
inaccsp
Inaccuracy component of the relative binary timestamp, in the
form of seconds and nanoseconds.
2 – Description
The Binary Relative Time routine converts a relative binary
timestamp to two timespec structures that express relative
time and inaccuracy. These timespec structures describe a time
interval.
3 – Returns
0 Indicates that the routine executed successfully.
-1 Indicates an invalid time argument or invalid results.
4 – Example
The following example measures the duration of a process, then
prints the resulting relative time and inaccuracy.
utc_t before, duration;
reltimespec_t tduration;
timespec_t iduration;
/*
* Get the time before the start of the operation...
*/
utc_gettime(&before); /* Out: Before binary timestamp */
/*
* ...Later...
*
* Subtract, getting the duration as a relative time.
*
* NOTE: The NULL argument is used to obtain the current time.
*/
utc_subtime(&duration, /* Out: Duration rel bin timestamp */
(utc_t *)0, /* In: After binary timestamp */
&before); /* In: Before binary timestamp */
/*
* Convert the relative times to timespec structures...
*/
utc_binreltime(&tduration, /* Out: Duration time timespec */
&iduration, /* Out: Duration inacc timespec */
&duration); /* In: Duration rel bin timestamp */
/*
* Print the duration...
*/
printf("%d.%04d", tduration.tv_sec, (tduration.tv_nsec/10000));
if ((long)iduration.tv_sec == -1)
printf("Iinf\n");
else
printf("I%d.%04d\n", iduration.tv_sec, (iduration.tv_nsec/100000));
5 – Related Functions
utc_mkbinreltime