NAME¶
optionSaveState - saves the option state to memory
SYNOPSIS¶
#include <
your-opts.h>
cc [...] -o outfile infile.c -l
opts [...]
void
optionSaveState(tOptions*
pOpts);
DESCRIPTION¶
This routine will allocate enough memory to save the current option processing
state. If this routine has been called before, that memory will be reused. You
may only save one copy of the option state. This routine may be called before
optionProcess(3AO). If you do call it before the first call to optionProcess,
then you may also change the contents of argc/argv after you call
optionRestore(3AO)
In fact, more strongly put: it is safest to only use this function before having
processed any options. In particular, the saving and restoring of stacked
string arguments and hierarchical values is disabled. The values are not
saved.
- pOpts
- program options descriptor
ERRORS¶
If it fails to allocate the memory, it will print a message to stderr and exit.
Otherwise, it will always succeed.
SEE ALSO¶
The
info documentation for the -l
opts library.
ao_string_tokenize(3),
configFileLoad(3),
optionFileLoad(3),
optionFindNextValue(3),
optionFindValue(3),
optionFree(3),
optionGetValue(3),
optionLoadLine(3),
optionMemberList(3),
optionNextValue(3),
optionOnlyUsage(3),
optionPrintVersion(3),
optionPrintVersionAndReturn(3),
optionProcess(3),
optionRestore(3),
optionSaveFile(3),
optionUnloadNested(3),
optionVersion(3),
strequate(3),
streqvcmp(3),
streqvmap(3),
strneqvcmp(3),
strtransform(3),