longjmp

void longjmp( jmp_buf env, int status );

_Noreturn void longjmp( jmp_buf env, int status );

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

Carga el contexto de ejecución env guardado por una llamada previa a setjmp. Esta función no retorna. El control se transfiere al sitio de llamada de la macro setjmp que configuró env. Ese setjmp entonces devuelve el valor, pasado como status.

Si la función que llamó a setjmp ha terminado (ya sea por return o por otro longjmp más arriba en la pila), el comportamiento es indefinido. En otras palabras, solo se permiten saltos largos hacia arriba en la pila de llamadas.

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
}

Parámetros

Notas

longjmp está destinado para manejar condiciones de error inesperadas donde la función no puede retornar de manera significativa. Esto es similar al manejo de excepciones en otros lenguajes de programación.

Ejemplo

#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

Referencias

Véase también