optionFindNextValue (3) Linux Manual Page
optionFindNextValue – find a hierarcicaly valued option instance
Synopsis
#include <your-opts.h>
cc[...] - o outfile infile.c - lopts[...] const tOptionValue *optionFindNextValue(const tOptDesc *odesc, 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.
- odesc
- 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), optionMemberList(3), optionNextValue(3), optionOnlyUsage(3), optionProcess(3), optionRestore(3), optionSaveFile(3), optionSaveState(3), optionUnloadNested(3), optionVersion(3), strequate(3), streqvcmp(3), streqvmap(3), strneqvcmp(3), strtransform(3),