GNU AutoGen - The Automated Program Generator: 7.6.32.9 optionNextValue

[ < ] | [ > ] |  | [ << ] | [ Up ] | [ >> ] |  |  |  |  | [Top] | [Contents] | [Index] | [ ? ]

#### 7.6.32.9 optionNextValue

get the next value from a hierarchical list

Usage:

    const tOptionValue* res = optionNextValue( pOptValue, pOldValue );

Where the arguments are:

| Name | Type | Description
| —– | —– | ————-
| pOptValue | `const tOptionValue*` | a hierarchcal list value
| pOldValue | `const tOptionValue*` | a value from this list
| returns | const tOptionValue* | a compound value structure

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()`".

The returned result is NULL and errno is set:

- `EINVAL` - the `pOptValue` does not point to a valid hierarchical option value or `pOldValue` does not point to a member of that option value.
- `ENOENT` - the supplied `pOldValue` pointed to the last entry.

This document was generated by Bruce Korb on March 7, 2011 using texi2html 1.82.