optionFindNextValue(3)

optionFindNextValue3

Find a hierarcicaly valued option instance

Usage

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

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

Overview

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

an option with a nested arg type

pPrevVal

the last entry

name

name of value to find

value

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

Releases

9 releases since Debian 6.0 (Squeeze); the text changed 8 times.

  1. 6.0
  2. 7
  3. 8
  4. 9
  5. 10
  6. 11
  7. 12
  8. 13
  9. Arch

From autogen 5.18.16-6 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.