longjmp

 

C

编译器支持

语言

头文件

类型支持

程序实用程序

可变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间实用程序

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

程序支持实用程序

程序终止
abort exit quick_exit (C11) _Exit (C99)	atexit at_quick_exit (C11) EXIT_SUCCESSEXIT_FAILURE
不可到达的控制流
unreachable (C23)
与环境通信
getenvgetenv_s (C11)	system
内存对齐查询
memalignment (C23)
信号
signal raise sig_atomic_t	SIG_DFLSIG_IGN SIG_ERR
信号类型
SIGABRTSIGFPESIGILL	SIGINTSIGSEGVSIGTERM
非局部跳转
setjmp	longjmp
类型
jmp_buf

 

定义在头文件 <setjmp.h> 中
void longjmp( jmp_buf env, int status );		(直到 C11)
_Noreturn void longjmp( jmp_buf env, int status );		(从 C11 开始) (直到 C23)
[[noreturn]] void longjmp( jmp_buf env, int status );		(从 C23 开始)

加载由先前对 setjmp 的调用保存的执行上下文 env。此函数不会返回。控制权将转移到设置 env 的宏 setjmp 的调用位置。该 setjmp 然后返回作为 status 传递的值。

如果调用 setjmp 的函数已退出（无论是通过返回还是通过堆栈中更高级别的不同 longjmp），则行为未定义。换句话说，只允许向上跳跃调用堆栈。

跨线程跳转（如果调用 setjmp 的函数由另一个线程执行）也是未定义的行为。

(从 C11 开始)

如果调用 setjmp 时，VLA 或其他 可变修饰类型 变量在范围内，并且控制权离开了该范围，则 longjmp 到该 setjmp 会调用未定义的行为，即使控制权仍然在函数内。 在向上返回堆栈的过程中，longjmp 不会释放任何 VLA，如果以这种方式终止它们的生命周期，可能会发生内存泄漏。 void g(int n) { int a[n]; // a may remain allocated h(n); // does not return } void h(int n) { int b[n]; // b may remain allocated longjmp(buf, 2); // might cause a memory leak for h's b and g's a }

(从 C99 开始)

参数

env	-	引用由 setjmp 保存的程序执行状态的变量
status	-	要从 setjmp 返回的值。如果它等于 ​0​，则使用 1 代替

返回值

(无)

说明

longjmp 用于处理无法有意义地返回的函数的意外错误条件。这类似于其他编程语言中的异常处理。

示例

运行此代码

#include <stdio.h>
#include <setjmp.h>
#include <stdnoreturn.h>
 
jmp_buf my_jump_buffer;
 
noreturn void 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)
{
    volatile int count = 0; // modified local vars in setjmp scope must be volatile
    if (setjmp(my_jump_buffer) != 5) // compare against constant in an if
        foo(++count);
}

输出

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

参考文献

• C17 标准 (ISO/IEC 9899:2018)

• 7.13.2.1 longjmp 宏 (p: 191-192)

• C11 标准 (ISO/IEC 9899:2011)

• 7.13.2.1 longjmp 宏 (p: 263-264)

• C99 标准 (ISO/IEC 9899:1999)

• 7.13.2.1 longjmp 宏 (p: 244-245)

• C89/C90 标准 (ISO/IEC 9899:1990)

• 4.6.2.1 longjmp 函数

另请参见

setjmp	保存上下文 (函数宏)
C++ 文档 针对 longjmp