longjmp

void longjmp( jmp_buf env, int status );

_Noreturn void longjmp( jmp_buf env, int status );

[[noreturn]] void longjmp( jmp_buf env, int status );

Загружает контекст выполнения env сохранённый предыдущим вызовом setjmp. Эта функция не возвращается. Управление передаётся в место вызова макроса setjmp который установил env. Этот setjmp затем возвращает значение, переданное как status.

Если функция, вызвавшая setjmp завершилась (возвратом или другим longjmp выше по стеку), поведение не определено. Иными словами, разрешены только длинные переходы вверх по стеку вызовов.

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
}

Параметры

Примечания

longjmp предназначена для обработки неожиданных ошибочных ситуаций, когда функция не может вернуться осмысленно. Это похоже на обработку исключений в других языках программирования.

Пример

#include <setjmp.h>
#include <stdio.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

Ссылки

См. также