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

NAME

6       optionLoadLine - process a string for an option name and value
7
8

SYNOPSIS

10       #include <your-opts.h>
11       cc [...] -o outfile infile.c -lopts [...]
12
13       void optionLoadLine(tOptions* pOpts, char const* pzLine);
14
15

DESCRIPTION

17       This is a client program callable routine for setting options from, for
18       example, the contents of a file that they read in.  Only one option may
19       appear  in  the  text.   It  will  be  treated as a normal (non-preset)
20       option.
21
22       When passed a pointer to the option struct and a string, it  will  find
23       the  option  named  by the first token on the string and set the option
24       argument to the remainder of the string.  The caller must NUL terminate
25       the  string.   Any  embedded  new  lines will be included in the option
26       argument.  If the input looks like one or more quoted strings, then the
27       input  will be "cooked".  The "cooking" is identical to the string for‐
28       mation used in AutoGen  definition  files  (@pxref{basic  expression}),
29       except that you may not use backquotes.
30
31       pOpts  program options descriptor
32
33       pzLine NUL-terminated text
34
35

ERRORS

37       Invalid  options  are  silently ignored.  Invalid option arguments will
38       cause a warning to print, but the function should return.
39

SEE ALSO

41       The info documentation for the -lopts library.
42       ao_string_tokenize(3),  configFileLoad(3),  optionFileLoad(3),  option‐
43       FindNextValue(3), optionFindValue(3), optionFree(3), optionGetValue(3),
44       optionNextValue(3),  optionOnlyUsage(3),  optionProcess(3),   optionRe‐
45       store(3), optionSaveFile(3), optionSaveState(3), optionUnloadNested(3),
46       optionVersion(3),  pathfind(3),   strequate(3),   streqvcmp(3),   stre‐
47       qvmap(3), strneqvcmp(3), strtransform(3),
48
49
50
51                                  2008-02-27                 optionLoadLine(3)
Impressum