Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

setjmp — zapis środowiska wywołania

`setjmp` zapisuje środowisko w `jmp_buf`, umożliwiając późniejszy powrót przez `longjmp`.

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

Składnia

#include <setjmp.h>
int setjmp(jmp_buf env);

setjmp z <setjmp.h> jest opisywane jako makro, nie zwykła funkcja. Zwraca początkowo 0; po longjmp(env, value) zwraca value, przy czym 0 zostaje zastąpione przez 1.

Wywołanie setjmp może stanowić całe wyrażenie sterujące instrukcji wyboru lub pętli. Może też być operandem jednoargumentowego operatora ! lub jednym z operandów operatora relacji, równości albo nierówności, jeśli drugi operand jest całkowitym wyrażeniem stałym. W tych dwóch ostatnich przypadkach wynikowe wyrażenie musi stanowić całe wyrażenie sterujące instrukcji wyboru lub pętli. Wywołanie może też stanowić całe wyrażenie instrukcji wyrażeniowej, opcjonalnie z rzutowaniem na void. Każdy inny kontekst powoduje niezdefiniowane zachowanie. Dotyczy to zarówno int result = setjmp(env);, jak i użycia wywołania jako wyrażenia sterującego konstrukcji _Generic, mimo że to wyrażenie nie jest obliczane.

Cel musi pozostawać aktywny w tym samym wątku. Zmienione lokalne obiekty automatyczne bez volatile w funkcji zapisującej środowisko stają się nieokreślone. Skok nie cofa operacji wejścia/wyjścia.

Przykłady

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

int main(void)
{
    jmp_buf env;
    if (setjmp(env) == 0) {
        longjmp(env, 1);
    } else {
        puts("resumed");
    }
    return 0;
}

Wynik

resumed

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

Źródła