База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници