Autodocs
Libraries:
locale.library
--environment_vars--
--rexxhost--
--structures--
CloseCatalog
CloseLocale
ConvToLower
ConvToUpper
FormatDate
FormatString
GetCatalogStr
GetLocaleStr
IsXXXX
OpenCatalogA
OpenLocale
ParseDate
StrConvert
StrnCmp
Include
GuruMeditation
|
Docs » Autodocs » locale.library » ParseDate
ParseDate -- interpret a string according to the date formatting
template and convert it into a DateStamp. (V38)
state = ParseDate(locale,date,fmtTemplate,getCharFunc);
D0 A0 A1 A2 A3
BOOL ParseDate(struct Locale *,struct DateStamp *,STRPTR,struct Hook *);
This function converts a stream of characters into an AmigaDOS
DateStamp structure. The characters are obtained from the
getCharFunc callback hook and the formatting template is used
to direct the parse.
locale - the locale to use for the formatting
date - place to put the converted date, this may be NULL in which
case this routine can be used to simply validate a date
fmtTemplate - the date template describing the expected format of the
data. See FormatDate() documentation for a description of
date templates. The following formatting controls from
FormatDate() can be used in ParseDate():
%a %A %b %B %d %e %h %H %I %m %M %p %S %y %Y
getCharFunc - a callback hook invoked whenever a character is required.
The hook should return the next character to process,
with a NULL character to indicate the end of the string.
The hook is called with:
A0 - address of Hook structure
A1 - locale pointer
A2 - NULL
The hook returns the character to process in D0. Note
that a complete 32-bit result is expected in D0, not
just 8 bits.
state - TRUE if the parsing went OK, or FALSE if the input did not
match the template
FormatDate(), <dos/dos.h>
|
