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)