AutoGen: libopts-optionSaveFile

[ < ] | [ > ] |  | [ << ] | [ Up ] | [ >> ] |  |  |  |  | [Top] | [Contents] | [Index] | [ ? ]

#### 7.4.28.5 optionSaveFile

saves the option state to a file

Usage:

    optionSaveFile( pOpts );

Where the arguments are:

| Name | Type | Description
| ----- | ----- | -------------
| pOpts | `tOptions*` | program options descriptor

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.

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.

This document was generated by Bruce Korb on February 23, 2004 using texi2html