Man Linux: Main Page and Category List

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),

                                  2010-02-10            optionFindNextValue(3)