---
name: "optionRestore"
section: "3"
platform: "linux"
package: "autogen"
version: "5.18.16-6"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/optionRestore"
---

# optionRestore(3)

restore option state from memory copy

## NAME

optionRestore - restore option state from memory copy

## SYNOPSIS

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

void **optionRestore**(tOptions \* *pOpts*);

## DESCRIPTION

Copy back the option state from saved memory. The allocated memory is left intact, so this routine can be called repeatedly without having to call optionSaveState again. If you are restoring a state that was saved before the first call to optionProcess(3AO), then you may change the contents of the argc/argv parameters to optionProcess.

- *pOpts*

  program options descriptor

## ERRORS

If you have not called **optionSaveState** before, a diagnostic is printed to **stderr** and exit is called.

## SEE ALSO

The *info* documentation for the -l*opts* library.\
 [ao\_string\_tokenize(3)](/ao_string_tokenize/3.md), [configFileLoad(3)](/configFileLoad/3.md), [optionFileLoad(3)](/optionFileLoad/3.md), [optionFindNextValue(3)](/optionFindNextValue/3.md), [optionFindValue(3)](/optionFindValue/3.md), [optionFree(3)](/optionFree/3.md), [optionGetValue(3)](/optionGetValue/3.md), [optionLoadLine(3)](/optionLoadLine/3.md), [optionMemberList(3)](/optionMemberList/3.md), [optionNextValue(3)](/optionNextValue/3.md), [optionOnlyUsage(3)](/optionOnlyUsage/3.md), [optionPrintVersion(3)](/optionPrintVersion/3.md), [optionPrintVersionAndReturn(3)](/optionPrintVersionAndReturn/3.md), [optionProcess(3)](/optionProcess/3.md), [optionSaveFile(3)](/optionSaveFile/3.md), [optionSaveState(3)](/optionSaveState/3.md), [optionUnloadNested(3)](/optionUnloadNested/3.md), [optionVersion(3)](/optionVersion/3.md), [strequate(3)](/strequate/3.md), [streqvcmp(3)](/streqvcmp/3.md), [streqvmap(3)](/streqvmap/3.md), [strneqvcmp(3)](/strneqvcmp/3.md), [strtransform(3)](/strtransform/3.md),