bstr_string_to_time(3) — Subroutines
Name
bstr_string_to_time − Converts a string into a BASEstar Open time variable.
Syntax
bstr_t_status bstr_string_to_time (
char ∗buf,
bstr_t_time ∗ptv);
Description
The bstr_string_to_time procedure converts a NULL-terminated string into a BASEstar Open variable of the bstr_t_time type. Specify a string of 32 characters in the following format:
DDD MMM dd hh:mm:ss tttttt YYYY
Where:
•DDD = first three characters of the day (optional)
•MMM = first three characters of the month
•dd = date
•hh = hour
•mm = minutes
•ss = seconds
•tttttt = milliseconds
•YYYY = year.
Arguments
buf
access: read
The address of the buffer containing the string.
ptv
access: read
The address in which BASEstar Open returns the time value.
Return Values
| BSTR_S_BAD_PARAMETER | Bad parameter value |
| BSTR_S_COM_PC_SIZE_MISMATCH | Number of bytes requested does not match the number of bytes returned |
| BSTR_S_NORMAL | Normal successful completion |
See Also
| bstr_time_compare | # |
| bstr_get_time | # |
| bstr_time_convert | # |
| bstr_time_to_string | # |