CKTIS / C
<setjmp.h> — нелокални скокове
Заглавният файл <setjmp.h> запазва точка за връщане и възобновява изпълнението от нея при вложено извикване. Това изисква строг контрол върху времето на живот и ресурсите.
Версия: C23; repository compiler flag, production runtime not attested
Синтаксис
#include <setjmp.h>
jmp_buf env;
int setjmp(jmp_buf env);
[[noreturn]] void longjmp(jmp_buf env, int val);<setjmp.h> предоставя масивния тип jmp_buf, макроса setjmp и функцията longjmp. В C23 стойността на __STDC_VERSION_SETJMP_H__ е 202311L. Декларацията на setjmp в синтаксиса е описателна: не я декларирайте сами и не потискайте макроса ѝ.
setjmp(env) запазва средата на извикване и първоначално връща 0. longjmp(env, val) възобновява изпълнението от тази точка с резултат val, като заменя 0 с 1; никога не се връща при извикващата я функция.
Целият управляващ израз на оператор за избор или цикъл може да бъде самото извикване на setjmp, логическото му отрицание (!) или сравнение с оператор за наредба, равенство или неравенство, при което единият операнд е извикването, а другият е целочислен константен израз. Извикването на setjmp, със или без явно преобразуване към void, може също да бъде целият израз на оператор-израз. Не използвайте setjmp като условие на оператора ?:. Инициализацията int r = setjmp(env); води до неопределено поведение.
Целта трябва да остане активна в същата нишка; никога не прескачайте към приключила функция или към напуснат обхват на тип с променлива модификация. Автоматичните локални обекти на целевата функция, които не са volatile и са се променили след запазването на средата, имат неопределено представяне. Скокът пропуска кода за почистване, не освобождава ресурси и не възстановява състоянието на файловете или средата с плаваща запетая.
Примери
#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;
}
Резултат
before recovered
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.