1optionFindNextValue(3)        Programmer's Manual       optionFindNextValue(3)
2
3
4

NAME

6       optionFindNextValue - find a hierarcicaly valued option instance
7
8

SYNOPSIS

10       #include <your-opts.h>
11       cc [...] -o outfile infile.c -lopts [...]
12
13       const  tOptionValue * optionFindNextValue(const tOptDesc * odesc, const
14       tOptionValue * pPrevVal, char const * name, char const * value);
15
16

DESCRIPTION

18       This routine will find the next entry in a nested value option or  con‐
19       figurable.   It  will search through the list and return the next entry
20       that matches the criteria.
21
22       odesc  an option with a nested arg type
23
24       pPrevVal
25              the last entry
26
27       name   name of value to find
28
29       value  the matching value
30
31

RETURN VALUE

33       a compound value structure
34
35

ERRORS

37       The returned result is NULL and errno is set:
38
39
40
41
42
43
44
45       EINVAL - the pOptValue does not point to a  valid  hierarchical  option
46       value.
47
48       ENOENT - no entry matched the given name.  @end itemize
49

SEE ALSO

51       The info documentation for the -lopts library.
52       ao_string_tokenize(3),  configFileLoad(3),  optionFileLoad(3),  option‐
53       FindValue(3), optionFree(3), optionGetValue(3), optionLoadLine(3),  op‐
54       tionMemberList(3), optionNextValue(3), optionOnlyUsage(3), optionPrint‐
55       Version(3), optionPrintVersionAndReturn(3), optionProcess(3), optionRe‐
56       store(3), optionSaveFile(3), optionSaveState(3), optionUnloadNested(3),
57       optionVersion(3),     strequate(3),     streqvcmp(3),     streqvmap(3),
58       strneqvcmp(3), strtransform(3),
59
60
61
62                                  2023-07-19            optionFindNextValue(3)
Impressum