Next: optionFree, Previous: optionFindNextValue, Up: libopts External Procedures [Contents][Index]
find a hierarcicaly valued option instance
Usage:
const tOptionValue * res = optionFindValue( odesc, name, val );
Where the arguments are:
| Name | Type | Description | |
| —– | —– | ————- | |
| odesc | const tOptDesc * | an option with a nested arg type | |
| name | char const * | name of value to find | |
| val | char const * | the matching value | |
| returns | const tOptionValue * | a compound value structure |
This routine will find an entry in a nested value option or configurable. It will search through the list and return a matching entry.
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.