longjmp

void longjmp( jmp_buf env, int status );

_Noreturn void longjmp( jmp_buf env, int status );

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

Lädt den Ausführungskontext env gespeichert durch einen vorherigen Aufruf von setjmp. Diese Funktion kehrt nicht zurück. Die Kontrolle wird an die Aufrufstelle des Makros setjmp übergeben, das env eingerichtet hat. Dieses setjmp gibt dann den Wert zurück, der als status übergeben wurde.

Wenn die Funktion, die setjmp aufgerufen hat, beendet wurde (entweder durch Rückkehr oder durch ein anderes longjmp weiter oben im Stack), ist das Verhalten undefiniert. Mit anderen Worten, es sind nur Longjumps nach oben im Aufrufstack erlaubt.

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
}

Parameter

Anmerkungen

longjmp ist für die Behandlung unerwarteter Fehlerzustände gedacht, bei denen die Funktion nicht sinnvoll zurückkehren kann. Dies ähnelt der Ausnahmebehandlung in anderen Programmiersprachen.

Beispiel

#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

Referenzen

Siehe auch