The Single UNIX ® Specification, Version 2
Copyright © 1997 The Open Group


setjmp - set jump point for a non-local goto


#include <setjmp.h>

int setjmp(jmp_buf env);


A call to setjmp(), saves the calling environment in its env argument for later use by longjmp().

It is unspecified whether setjmp() is a macro or a function. If a macro definition is suppressed in order to access an actual function, or a program defines an external identifier with the name setjmp the behaviour is undefined.

All accessible objects have values as of the time longjmp() was called, except that the values of objects of automatic storage duration which are local to the function containing the invocation of the corresponding setjmp() which do not have volatile-qualified type and which are changed between the setjmp() invocation and longjmp() call are indeterminate.

An invocation of setjmp() must appear in one of the following contexts only:


If the return is from a direct invocation, setjmp() returns 0. If the return is from a call to longjmp(), setjmp() returns a non-zero value.


No errors are defined.




In general, sigsetjmp() is more useful in dealing with errors and interrupts encountered in a low-level subroutine of a program.




longjmp(), sigsetjmp(), <setjmp.h>.


Derived from Issue 1 of the SVID.

UNIX ® is a registered Trademark of The Open Group.
Copyright © 1997 The Open Group
[ Main Index | XSH | XCU | XBD | XCURSES | XNS ]