NAME¶
optionFindNextValue - find a hierarcicaly valued option instance
SYNOPSIS¶
#include <
your-opts.h>
cc [...] -o outfile infile.c -l
opts [...]
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 -l
opts 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),
