NAME

       pmParseInterval  -  convert  interval  string  to  timeval
       structure


C SYNOPSIS

       #include <pcp/pmapi.h>

       int pmParseInterval(const  char  *string,  struct  timeval
       *rslt, char **errmsg)

       cc ... -lpcp


DESCRIPTION

       pmParseInterval  parses  the argument string specifying an
       interval of time and fills in the tv_sec and tv_usec  com­
       ponents  of the rslt structure to represent that interval.

       The input string is most commonly the argument following a
       -t  command line option to a PCP application, and the syn­
       tax is fully described in PCPIntro(1).

       pmParseInterval returns 0 and errmsg is undefined  if  the
       parsing is successful.

       If  the given string does not conform to the required syn­
       tax pmParseInterval returns -1 and a dynamically allocated
       error message string in errmsg.  The error message is ter­
       minated with a newline and includes the text of the  input
       string  along  with  an indicator of the position at which
       the error was detected, e.g.
                 4minutes 30mumble
                            ^ -- unexpected value

       In the case of an error, the  caller  is  responsible  for
       calling  free(3C)  to  release  the  space  allocated  for
       errmsg.


SEE ALSO

       PMAPI(3) and pmParseTimeWindow(3).


Man(1) output converted with man2html