1optionFindNextValue(3) Programmer's Manual optionFindNextValue(3)
2
3
4
6 optionFindNextValue - find a hierarcicaly valued option instance
7
8
10 #include <your-opts.h>
11 cc [...] -o outfile infile.c -lopts [...]
12
13 const tOptionValue* optionFindNextValue(const tOptDesc* pOptDesc, const
14 tOptionValue* pPrevVal, char const* name, char const* value);
15
16
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 pOptDesc
23 an option with a nested arg type
24
25 pPrevVal
26 the last entry
27
28 name name of value to find
29
30 value the matching value
31
32
34 a compound value structure
35
36
38 The returned result is NULL and errno is set:
39
40
41
42
43
44
45
46 EINVAL - the pOptValue does not point to a valid hierarchical option
47 value.
48
49 ENOENT - no entry matched the given name. @end itemize
50
52 The info documentation for the -lopts library.
53 ao_string_tokenize(3), configFileLoad(3), optionFileLoad(3), option‐
54 FindValue(3), optionFree(3), optionGetValue(3), optionLoadLine(3),
55 optionNextValue(3), optionOnlyUsage(3), optionProcess(3), optionRe‐
56 store(3), optionSaveFile(3), optionSaveState(3), optionUnloadNested(3),
57 optionVersion(3), pathfind(3), strequate(3), streqvcmp(3), stre‐
58 qvmap(3), strneqvcmp(3), strtransform(3),
59
60
61
62 2009-08-10 optionFindNextValue(3)