1optionLoadLine(3) Programmer's Manual optionLoadLine(3)
2
3
4
6 optionLoadLine - process a string for an option name and value
7
8
10 #include <your-opts.h>
11 cc [...] -o outfile infile.c -lopts [...]
12
13 void optionLoadLine(tOptions* pOpts, char const* pzLine);
14
15
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
37 Invalid options are silently ignored. Invalid option arguments will
38 cause a warning to print, but the function should return.
39
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 2009-08-10 optionLoadLine(3)