Name

utc_spantime - Given two (possibly unordered) binary timestamps, returns a single UTC time interval whose inaccuracy spans the two input binary timestamps

Synopsis

#include <dce/utc.h> int utc_spantime(
utc_t ∗result,
utc_t ∗utc1,
utc_t ∗utc2);

Parameters

Input

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

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

Output

resultSpanning timestamp. 

Description

Given two binary timestamps, the utc_spantime() routine returns a single UTC time interval whose inaccuracy spans the two input timestamps (that is, the interval resulting from the earliest possible time of either timestamp to the latest possible time of either timestamp). 

Notes

The tdf parameter in the output UTC value is copied from the utc2 input.  If either input binary timestamp has an unspecified inaccuracy, an error is returned. 

Return Values

 0Indicates that the routine executed successfully. 

-1Indicates an invalid time argument. 

Examples

The following example computes the earliest and latest times for an array of 10 timestamps. 

utc_t               time_array[10], testtime, earliest, latest;
int                 i;
 /∗   Set the running timestamp to the first entry...
 ∗/
testtime = time_array[0];
 for (i=1; i<10; i++) {
    /∗   Compute the minimum and the maximum against the next
    ∗   element...
    ∗/
utc_spantime(&testtime,        /∗ Out: Resultant interval          ∗/
             &testtime,        /∗ In:  Largest previous interval   ∗/
             &time_array[i]);  /∗ In:  Element under test          ∗/
}
 /∗   Compute the earliest and latest possible times
 ∗/
 utc_pointtime(&earliest,       /∗ Out: Earliest poss time in array ∗/
             (utc_t ∗)0,       /∗ Out: Midpoint                    ∗/
             &latest,          /∗ Out: Latest poss time in array   ∗/
             &testtime);       /∗ In:  Spanning interval           ∗/

Related Information

Functions: utc_boundtime(3dts), utc_gettime(3dts), utc_pointtime(3dts).