setjmp
Saves the current state of the program.
int setjmp( jmp_buf env );
Parameters
- env
-
Variable in which environment is stored.
The setjmp function saves a stack environment, which you can subsequently restore, using longjmp. When used together, setjmp and longjmp provide a way to execute a non-local goto. They are typically used to pass execution control to error-handling or recovery code in a previously called routine without using the normal calling or return conventions.
A call to setjmp saves the current stack environment in env. A subsequent call to longjmp restores the saved environment and returns control to the point just after the corresponding setjmp call. All variables (except register variables) accessible to the routine receiving control contain the values they had when longjmp was called.
It is not possible to use setjmp to jump from native to managed code.
Note setjmp and longjmp do not support C++ object semantics. In C++ programs, use the C++ exception-handling mechanism.
For more information, see Using setjmp and longjmp.
| Routine | Required header | Compatibility |
|---|---|---|
| setjmp | <setjmp.h> | ANSI, Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 |
For additional compatibility information, see Compatibility in the Introduction.
Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.
