NAME

       optionGetValue - get a specific value from a hierarcical list

SYNOPSIS

       #include <your-opts.h>
       cc [...] -o outfile infile.c -lopts [...]

       const   tOptionValue  *  optionGetValue(const  tOptionValue  *  pOptValue,  char  const  *
       valueName);

DESCRIPTION

       This routine will find an entry in a nested value option or configurable.  If  "valueName"
       is  NULL,  then  the first entry is returned.  Otherwise, the first entry with a name that
       exactly matches the argument will be returned.  If there is no  matching  value,  NULL  is
       returned  and  errno  is set to ENOENT. If the provided option value is not a hierarchical
       value, NULL is also returned and errno is set to EINVAL.

       pOptValue
              a hierarchcal value

       valueName
              name of value to get

RETURN VALUE

       a compound value structure

ERRORS

       The returned result is NULL and errno is set:

       EINVAL - the pOptValue does not point to a valid hierarchical option value.

       ENOENT - no entry matched the given name.  @end itemize

SEE ALSO

       The info documentation for the -lopts library.
       ao_string_tokenize(3),   configFileLoad(3),   optionFileLoad(3),   optionFindNextValue(3),
       optionFindValue(3),       optionFree(3),      optionLoadLine(3),      optionMemberList(3),
       optionNextValue(3),               optionOnlyUsage(3),               optionPrintVersion(3),
       optionPrintVersionAndReturn(3),   optionProcess(3),  optionRestore(3),  optionSaveFile(3),
       optionSaveState(3), optionUnloadNested(3), optionVersion(3),  strequate(3),  streqvcmp(3),
       streqvmap(3), strneqvcmp(3), strtransform(3),

                                            2018-01-06                          optionGetValue(3)