Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

<setjmp.h> — nelokalni skoki

Glava <setjmp.h> shrani povratno točko in omogoča nadaljevanje izvajanja na tej točki iz gnezdenega klica. Zahteva strog nadzor nad življenjskimi dobami in viri.

Različica: C23; repository compiler flag, production runtime not attested

Sintaksa

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

<setjmp.h> ponuja tip polja jmp_buf, makro setjmp in funkcijo longjmp. V C23 je vrednost __STDC_VERSION_SETJMP_H__ enaka 202311L. Deklaracija setjmp v sintaksi je opisna: ne deklarirajte je sami in ne onemogočite njenega makra.

setjmp(env) shrani klicno okolje in sprva vrne 0. longjmp(env, val) nadaljuje izvajanje na tej točki z rezultatom val in pri tem 0 nadomesti z 1; nikoli se ne vrne k svojemu klicatelju.

Celoten krmilni izraz izbirnega stavka ali zanke lahko tvori sam klic setjmp, njegova logična negacija (!) ali primerjava z relacijskim operatorjem ali operatorjem za enakost oziroma neenakost, pri kateri je en operand klic, drugi pa celoštevilski konstantni izraz. Klic setjmp, po želji izrecno pretvorjen v void, lahko tvori tudi celoten izraz izraznega stavka. Klica setjmp ne uporabljajte kot pogoja operatorja ?:. Inicializacija int r = setjmp(env); povzroči nedefinirano vedenje.

Cilj mora ostati aktiven v isti niti; nikoli ne skočite v končano funkcijo ali v že zapuščeni doseg spremenljivo modificiranega tipa. Samodejni lokalni objekti ciljne funkcije, ki niso volatile in so se spremenili od shranitve okolja, imajo nedoločeno predstavitev. Skok preskoči kodo za čiščenje, ne sprosti virov in ne obnovi stanja datotek ali okolja s plavajočo vejico.

Primeri

#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;
}

Rezultat

before
recovered

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri