Saves the current execution context into a variableenv of typejmp_buf. This variable can later be used to restore the current execution context bylongjmp function. That is, when a call tolongjmp function is made, the execution continues at the particular call site that constructed thejmp_buf variable passed tolongjmp. In that casesetjmp returns the value passed tolongjmp.

The invocation ofsetjmp must appear only in one of the following contexts:

1. The entire controlling expression ofif,switch,while,do-while,for.

   switch(setjmp(env)){// ...

2. One operand of a relational or equality operator with the other operand an integer constant expression, with the resulting expression being the entire controlling expression ofif,switch,while,do-while,for.

   if(setjmp(env)>10){// ...

3. The operand of a unary ! operator with the resulting expression being the entire controlling expression ofif,switch,while,do-while,for.

   while(!setjmp(env)){// ...

4. The entire expression of anexpression statement (possibly cast tovoid).

   setjmp(env);

Ifsetjmp appears in any other context, the behavior is undefined.

Upon return to the scope ofsetjmp:

• all accessible objects, floating-point status flags, and other components of the abstract machine have the same values as they had whenlongjmp was executed,
• except for the non-volatile local variables in the function containing the invocation ofsetjmp, whose values are indeterminate if they have been changed since thesetjmp invocation.

[edit]Parameters

[edit]Return value

​0​ if the macro was called by the original code and the execution context was saved toenv.

Non-zero value if a non-local jump was just performed. The return value is the same as passed tolongjmp.

[edit]Notes

Above requirements forbid using return value ofsetjmp in data flow (e.g. to initialize or assign an object with it). The return value can only be either used in control flow or discarded.

[edit]Example

#include <stdio.h>#include <setjmp.h>#include <stdnoreturn.h> jmp_buf my_jump_buffer; noreturnvoid foo(int status){printf("foo(%d) called\n", status);longjmp(my_jump_buffer, status+1);// will return status+1 out of setjmp} int main(void){volatileint count=0;// modified local vars in setjmp scope must be volatileif(setjmp(my_jump_buffer)!=5)// compare against constant in an if        foo(++count);}

foo(1) calledfoo(2) calledfoo(3) calledfoo(4) called

[edit]References

[edit]See also

• In other languages

• العربية
• Česky
• Deutsch
• Español
• Français
• Italiano
• 日本語
• 한국어
• Polski
• Português
• Русский
• Türkçe
• 中文