1optionNextValue(3) Programmer's Manual optionNextValue(3)
2
3
4
6 optionNextValue - get the next value from a hierarchical list
7
8
10 #include <your-opts.h>
11 cc [...] -o outfile infile.c -lopts [...]
12
13 const tOptionValue* optionNextValue(const tOptionValue* pOptValue,
14 const tOptionValue* pOldValue);
15
16
18 This routine will return the next entry after the entry passed in. At
19 the end of the list, NULL will be returned. If the entry is not found
20 on the list, NULL will be returned and "errno" will be set to EINVAL.
21 The "pOldValue" must have been gotten from a prior call to this routine
22 or to "opitonGetValue()".
23
24 pOptValue
25 a hierarchcal list value
26
27 pOldValue
28 a value from this list
29
30
32 a compound value structure
33
34
36 The returned result is NULL and errno is set:
37
38
39
40
41
42
43
44 EINVAL - the pOptValue does not point to a valid hierarchical option
45 value or pOldValue does not point to a member of that option value.
46
47 ENOENT - the supplied pOldValue pointed to the last entry. @end item‐
48 ize
49
51 The info documentation for the -lopts library.
52 ao_string_tokenize(3), configFileLoad(3), optionFileLoad(3), option‐
53 FindNextValue(3), optionFindValue(3), optionFree(3), optionGetValue(3),
54 optionLoadLine(3), optionOnlyUsage(3), optionProcess(3), optionRe‐
55 store(3), optionSaveFile(3), optionSaveState(3), optionUnloadNested(3),
56 optionVersion(3), pathfind(3), strequate(3), streqvcmp(3), stre‐
57 qvmap(3), strneqvcmp(3), strtransform(3),
58
59
60
61 2008-02-27 optionNextValue(3)