Man Linux: Main Page and Category List


       optionSaveState - saves the option state to memory


       #include <your-opts.h>
       cc [...] -o outfile infile.c -lopts [...]

       void optionSaveState(tOptions* pOpts);


       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


       If  it  fails to allocate the memory, it will print a message to stderr
       and exit.  Otherwise, it will always succeed.


       The info documentation for the -lopts library.
       ao_string_tokenize(3),      configFileLoad(3),       optionFileLoad(3),
       optionFindNextValue(3),        optionFindValue(3),       optionFree(3),
       optionGetValue(3),        optionLoadLine(3),        optionNextValue(3),
       optionOnlyUsage(3),         optionProcess(3),         optionRestore(3),
       optionSaveFile(3),       optionUnloadNested(3),       optionVersion(3),
       pathfind(3),  strequate(3),  streqvcmp(3), streqvmap(3), strneqvcmp(3),

                                  2010-02-10                optionSaveState(3)