optionSaveFile(3)

💾 optionSaveFile(3) — saving your option state, bestie 💾

okay so this is the Programmer's Manual page for optionSaveFile, and it is literally here to save the state of option processing to a file. iconic behavior, no notes ✨

✨ SYNOPSIS ✨

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

void optionSaveFile(tOptions * opts);

🌸 DESCRIPTION 🌸

This routine saves 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 defaults to .programnamerc 🎀

If you want to specify another file, you should invoke the SET_OPT_SAVE_OPTS(filename) macro. iykyk 💅

The recommended usage is literally this:

optionProcess(&progOptions, argc, argv);
if (i_want_a_non_standard_place_for_this)
SET_OPT_SAVE_OPTS("myfilename");
optionSaveFile(&progOptions);

quick arg tea:

• opts — the 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. fr fr, that's the whole warning.

🦋 SEE ALSO 🦋

bestie, also check the info documentation for the -lopts library, plus these absolute icons: 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), optionSaveState(3), optionUnloadNested(3), optionVersion(3), strequate(3), streqvcmp(3), streqvmap(3), strneqvcmp(3), and strtransform(3) 🌈

---

🫶 kisses and bestie vibes from the optionSaveFile(3) page, dated 2018-08-26. 💖