Provided by: libopts25-dev_5.12-0.1ubuntu1_amd64 bug

NAME

       optionFindNextValue - find a hierarcicaly valued option instance

SYNOPSIS

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

       const  tOptionValue*  optionFindNextValue(const  tOptDesc*  pOptDesc,  const tOptionValue*
       pPrevVal, char const* name, char const* value);

DESCRIPTION

       This routine will find the next entry in a nested value option or configurable.   It  will
       search through the list and return the next entry that matches the criteria.

       pOptDesc
              an option with a nested arg type

       pPrevVal
              the last entry

       name   name of value to find

       value  the matching value

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),    optionFindValue(3),
       optionFree(3),       optionGetValue(3),       optionLoadLine(3),       optionNextValue(3),
       optionOnlyUsage(3),       optionProcess(3),      optionRestore(3),      optionSaveFile(3),
       optionSaveState(3), optionUnloadNested(3),  optionVersion(3),  pathfind(3),  strequate(3),
       streqvcmp(3), streqvmap(3), strneqvcmp(3), strtransform(3),

                                            2011-07-27                     optionFindNextValue(3)