Next: optionFindValue, Previous: optionFileLoad, Up: libopts External Procedures [Contents][Index]
find a hierarcicaly valued option instance
Usage:
const tOptionValue * res = optionFindNextValue( odesc, pPrevVal, name, value );
Where the arguments are:
| Name | Type | Description | |
| —– | —– | ————- | |
| odesc | const tOptDesc * | an option with a nested arg type | |
| pPrevVal | const tOptionValue * | the last entry | |
| name | char const * | name of value to find | |
| value | char const * | the matching value | |
| returns | const tOptionValue * | a compound value structure |
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.
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.