Poster of Linux kernelThe best gift for a Linux geek
optionSaveFile

optionSaveFile

Section: Programmer's Manual (3) Updated: 2010-02-10
Local index Up
 

NAME

optionSaveFile - saves the option state to a file

 

SYNOPSIS

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

void optionSaveFile(tOptions* pOpts);

 

DESCRIPTION

This routine will save the state of option processing to a file. The name of that file can be specified with the argument to the --save-opts option, or by appending the rcfile attribute to the last homerc attribute. If no rcfile attribute was specified, it will default to .programnamerc. If you wish to specify another file, you should invoke the SET_OPT_SAVE_OPTS( filename ) macro.

The recommend usage is as follows:

    optionProcess(&progOptions, argc, argv);
    if (i_want_a_non_standard_place_for_this)
    SET_OPT_SAVE_OPTS("myfilename");
    optionSaveFile(&progOptions);
pOpts
program options descriptor

 

ERRORS

If no homerc file was specified, this routine will silently return and do nothing. If the output file cannot be created or updated, a message will be printed to stderr and the routine will return.  

SEE ALSO

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), optionSaveState(3), optionUnloadNested(3), optionVersion(3), pathfind(3), strequate(3), streqvcmp(3), streqvmap(3), strneqvcmp(3), strtransform(3),


 

Index

NAME
SYNOPSIS
DESCRIPTION
ERRORS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 21:51:48 GMT, April 16, 2011