optionNextValue (3) Linux Manual Page
optionNextValue – get the next value from a hierarchical list
Synopsis
#include <your-opts.h>
cc[...] - o outfile infile.c - lopts[...] const tOptionValue *optionNextValue(const tOptionValue *pOptValue, const tOptionValue *pOldValue);
Description
This routine will return the next entry after the entry passed in. At the end of the list, NULL will be returned. If the entry is not found on the list, NULL will be returned and "errno" will be set to EINVAL. The "pOldValue" must have been gotten from a prior call to this routine or to "opitonGetValue()".
- pOptValue
- a hierarchcal list value
- pOldValue
- a value from this list
Return Value
a compound value structure
Errors
The returned result is NULL and errno is set:
EINVAL– thepOptValuedoes not point to a valid hierarchical option value orpOldValuedoes not point to a member of that option value.ENOENT– the suppliedpOldValuepointed to the last entry. @end itemizeSee Also
The info documentation for the -lopts library.
ao_string_tokenize(3), configFileLoad(3), optionFileLoad(3), optionFindNextValue(3), optionFindValue(3), optionFree(3), optionGetValue(3), optionLoadLine(3), optionMemberList(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),