---
name: "optionFindValue"
section: "3"
platform: "linux"
package: "autogen"
version: "5.18.16-6"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/optionFindValue"
---

# optionFindValue(3)

find a hierarcicaly valued option instance

## NAME

optionFindValue - find a hierarcicaly valued option instance

## SYNOPSIS

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

const tOptionValue \* **optionFindValue**(const tOptDesc \* *odesc*, char const \* *name*, char const \* *val*);

## DESCRIPTION

This routine will find an entry in a nested value option or configurable. It will search through the list and return a matching entry.

- *odesc*

  an option with a nested arg type

- *name*

  name of value to find

- *val*

  the matching value

## RETURN VALUE

a compound value structure

## 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

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