Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

<setjmp.h> — skoki nielokalne

Nagłówek <setjmp.h> pozwala zapisać punkt powrotu i wrócić do niego z zagnieżdżonego wywołania. Wymaga ścisłej kontroli czasu życia i zasobów.

Wersja: C23; repository compiler flag, production runtime not attested

Składnia

#include <setjmp.h>
jmp_buf env;
int setjmp(jmp_buf env);
[[noreturn]] void longjmp(jmp_buf env, int val);

<setjmp.h> udostępnia tablicowy typ jmp_buf, makro setjmp i funkcję longjmp. W C23 __STDC_VERSION_SETJMP_H__ ma wartość 202311L. Deklaracja setjmp w składni jest opisowa: nie deklaruj go samodzielnie ani nie wyłączaj makra.

setjmp(env) zapisuje środowisko wywołania i początkowo zwraca 0. longjmp(env, val) wznawia ten punkt z wynikiem val, zastępując 0 przez 1; nie wraca do swojego wywołującego.

Całym wyrażeniem sterującym instrukcji wyboru lub pętli może być samo wywołanie setjmp, jego negacja logiczna (!) albo porównanie, w którym wywołanie jest jednym operandem operatora relacyjnego lub operatora równości bądź nierówności, a drugim jest całkowite wyrażenie stałe. Wywołanie setjmp, opcjonalnie rzutowane na void, może też stanowić całe wyrażenie instrukcji wyrażeniowej. Nie wolno używać setjmp jako warunku operatora ?:. Inicjalizacja int r = setjmp(env); powoduje niezdefiniowane zachowanie.

Cel musi nadal istnieć w tym samym wątku; nie wracaj do zakończonej funkcji ani opuszczonego zakresu typu zmiennie modyfikowanego. Zmienione od zapisu lokalne obiekty automatyczne funkcji docelowej bez volatile mają nieokreśloną reprezentację. Skok pomija kod sprzątający, nie zwalnia zasobów ani nie przywraca stanu plików lub środowiska zmiennoprzecinkowego.

Przykłady

#include <setjmp.h>
#include <stdio.h>

static jmp_buf env;

static void fail(void)
{
    longjmp(env, 0);
}

int main(void)
{
    if (setjmp(env) == 0) {
        puts("before");
        fail();
        puts("unreachable");
    } else {
        puts("recovered");
    }
    return 0;
}

Wynik

before
recovered

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła