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

NAME

6       optionNextValue - get the next value from a hierarchical list
7
8

SYNOPSIS

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

DESCRIPTION

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

RETURN VALUE

32       a compound value structure
33
34

ERRORS

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

SEE ALSO

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)
Impressum