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.