utc_pointtime(3dts)
Converts a binary timestamp to three binary timestamps that represent the earliest, most likely, and latest time
Synopsis
#include <dce/utc.h>
int utc_pointtime(
utc_t *utclp,
utc_t *utcmp,
utc_t *utchp,
utc_t *utc);
Parameters
Input
utc
Binary timestamp or relative binary timestamp. Use NULL if you want this routine to use the current time for this parameter.
Output
utclp
Lowest (earliest) possible absolute time or shortest possible relative time that the input timestamp can represent.
utcmp
Midpoint of the input timestamp.
utchp
Highest (latest) possible absolute time or longest possible relative time that the input timestamp can represent.
Notes
All outputs have zero inaccuracy. An error is returned if the input binary timestamp has an unspecified inaccuracy.
Description
The utc_pointtime( ) routine converts a binary timestamp to three binary timestamps that represent the earliest, latest, and most likely (midpoint) times.
If the input is a relative binary time, the outputs represent relative binary times.
Return Values
~0 Indicates that the routine executed successfully.
1 Indicates an invalid time argument.
Examples
See the sample program in the utc_addtime(3dts) reference page.
Related Information
Functions: