NAME

       __pmParseCtime - convert ctime(3) string to tm structure


C SYNOPSIS

       #include <pcp/impl.h>

       int  __pmParseCtime(const  char  *string, struct tm *rslt,
       char **errmsg)

       cc ... -lpcp


DESCRIPTION

       __pmParseCtime  reverses  the  asctime(3C)  function.   It
       accepts a string specifying a time, and fills in the given
       tm structure.

       Either a fully specified asctime(3C) string like "Mon  Mar
       4  13:07:47  1996"  or  a  partially  specified  time like
       '1996", "Mar  1996",  "Mar  4  1996",  "Mar",  "13:07:47",
       "13:07",  "Mar  4 13:07:47",... is accepted.  In addition,
       the seconds component may be a floating point number,  for
       example  "13:07:47.5".   The  12  hour  clock is also sup­
       ported, so "13:07" and "1:07 pm" are equivalent.

       __pmParseCtime returns 0 if successful.  It returns -1 and
       a dynamically allocated error message string in errmsg, if
       the given string does not parse.  Be sure to free(3C)  the
       error message string.

       The  tm  structure returned in rslt should only be used as
       an argument to the __pmConvertTime function,  as  it  con­
       tains  encoded  information  that  will  only be correctly
       interpreted by __pmConvertTime.


SEE ALSO

       PMAPI(3),   pmParseInterval(3),   __pmConvertTime(3)   and
       __pmParseTime(3).


Man(1) output converted with man2html