utc_mkasctime(3dts)
Converts a NULL-terminated character string that represents an absolute timestamp to a binary timestamp
Synopsis
#include <dce/utc.h>
int utc_mkasctime(
utc_t *utc,
char *string);
Parameters
Input
string
A NULL-terminated string that expresses an absolute time.
Output
utc
Resulting binary timestamp.
Description
The utc_mkasctime( ) routine converts a NULL-terminated string that represents an absolute time to a binary timestamp.
Notes
The ASCII string must be NULL-terminated.
Return Values
~0 Indicates that the routine executed successfully.
1 Indicates an invalid time parameter or invalid results.
Examples
The following example converts an ASCII time string to its binary equivalent.
utc_t utc;
char str[UTC_MAX_STR_LEN];
/* July 4, 1776, 12:01:37.223 local time
* TDF of -5:00 hours
* Inaccuracy of 3600.32
seconds
*/
(void)strcpy((void *)str,
"1776-07-04-12:01:37.223-5:00I3600.32");
utc_mkasctime(&utc, /* Out: Binary utc */
str); /* In: String */
Related Information
Functions: