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* pOptDesc, 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       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

RETURN VALUE

34       a compound value structure
35
36

ERRORS

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

SEE ALSO

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