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

 NAME

setjmp - set jump point for a non-local goto

 SYNOPSIS



#include <setjmp.h>

int setjmp(jmp_buf env);

 DESCRIPTION

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:

 RETURN VALUE

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.

 ERRORS

No errors are defined.

 EXAMPLES

None.

 APPLICATION USAGE

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

 FUTURE DIRECTIONS

None.

 SEE ALSO

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

DERIVATION

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 ]