optionFindNextValue(3) Programmer's Manual optionFindNextValue(3)

# [NAME](#NAME)

optionFindNextValue - find a hierarcicaly valued option instance

# [SYNOPSIS](#SYNOPSIS)

#include <*your-opts.h*>  
cc \[...] -o outfile infile.c -l**opts** \[...]

const tOptionValue * **optionFindNextValue**(const tOptDesc * *odesc*, const tOptionValue * *pPrevVal*, char const * *name*, char const * *value*);

# [DESCRIPTION](#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*](#odesc)

an option with a nested arg type

[*pPrevVal*](#pPrevVal)

the last entry

[*name*](#name)

name of value to find

[*value*](#value)

the matching value

# [RETURN VALUE](#RETURN_VALUE)

a compound value structure

# [ERRORS](#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](#SEE_ALSO)

The *info* documentation for the -l*opts* library.  
[ao\_string\_tokenize(3)](/man/enterprise-packages/autogen/ao_string_tokenize.3), [configFileLoad(3)](/man/enterprise-packages/autogen/configFileLoad.3), [optionFileLoad(3)](/man/enterprise-packages/autogen/optionFileLoad.3), [optionFindValue(3)](/man/enterprise-packages/autogen/optionFindValue.3), [optionFree(3)](/man/enterprise-packages/autogen/optionFree.3), [optionGetValue(3)](/man/enterprise-packages/autogen/optionGetValue.3), [optionLoadLine(3)](/man/enterprise-packages/autogen/optionLoadLine.3), [optionMemberList(3)](/man/enterprise-packages/autogen/optionMemberList.3), [optionNextValue(3)](/man/enterprise-packages/autogen/optionNextValue.3), [optionOnlyUsage(3)](/man/enterprise-packages/autogen/optionOnlyUsage.3), [optionPrintVersion(3)](/man/enterprise-packages/autogen/optionPrintVersion.3), [optionPrintVersionAndReturn(3)](/man/enterprise-packages/autogen/optionPrintVersionAndReturn.3), [optionProcess(3)](/man/enterprise-packages/autogen/optionProcess.3), [optionRestore(3)](/man/enterprise-packages/autogen/optionRestore.3), [optionSaveFile(3)](/man/enterprise-packages/autogen/optionSaveFile.3), [optionSaveState(3)](/man/enterprise-packages/autogen/optionSaveState.3), [optionUnloadNested(3)](/man/enterprise-packages/autogen/optionUnloadNested.3), [optionVersion(3)](/man/enterprise-packages/autogen/optionVersion.3), [strequate(3)](/man/enterprise-packages/autogen/strequate.3), [streqvcmp(3)](/man/enterprise-packages/autogen/streqvcmp.3), [streqvmap(3)](/man/enterprise-packages/autogen/streqvmap.3), [strneqvcmp(3)](/man/enterprise-packages/autogen/strneqvcmp.3), [strtransform(3)](/man/enterprise-packages/autogen/strtransform.3),

2026-10-31

---

Document: optionFindNextValue(3) from autogen 5.18.16-r6 (Chainguard OS)
Source: https://git.savannah.gnu.org/git/autogen.git