debian man page for optionfindnextvalue

optionFindNextValue(3)						Programmer's Manual					    optionFindNextValue(3)

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-10						    optionFindNextValue(3)