Converts a binary timestamp to three binary timestamps that
    represent the earliest, most likely, and latest time.

    Format

      #include <utc.h>

      int utc_pointtime(*utclp, *utcmp, *utchp, *utc)

         utc_t *utclp;
         utc_t *utcmp;
         utc_t *utchp;
         const utc_t *utc;

1  –  Parameters

    Input

 utc

    Binary timestamp or relative binary timestamp.

    Output

 utclp

    Lowest (earliest) possible time that the input binary timestamp
    or shortest possible relative time that the relative binary
    timestamp can represent.

 utcmp

    Midpoint of the input binary timestamp or the midpoint of the
    input relative binary timestamp.

 utchp

    Highest (latest) possible time that the input binary timestamp
    or the longest possible relative time that the relative binary
    timestamp can represent.

2  –  Description

    The Point Time 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.

3  –  Notes

    All outputs have zero inaccuracy. An error is returned if the
    input binary timestamp has an infinite inaccuracy.

4  –  Returns

     0   Indicates that the routine executed successfully.
    -1   Indicates an invalid time argument.

5  –  Example

    See the sample program for the utc_addtime routine.

6  –  Related Functions

    utc_boundtime, utc_spantime