CKTIS / C
<setjmp.h> — nelokálne skoky
Hlavička <setjmp.h> uloží bod návratu a umožní pokračovať vo vykonávaní od neho z vnoreného volania. Vyžaduje prísnu kontrolu životnosti a prostriedkov.
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <setjmp.h>
jmp_buf env;
int setjmp(jmp_buf env);
[[noreturn]] void longjmp(jmp_buf env, int val);<setjmp.h> poskytuje typ poľa jmp_buf, makro setjmp a funkciu longjmp. V C23 má __STDC_VERSION_SETJMP_H__ hodnotu 202311L. Deklarácia setjmp v syntaxi je iba opisná: nedeklarujte ju sami a nepotláčajte jej makro.
setjmp(env) uloží prostredie volania a spočiatku vráti 0. longjmp(env, val) obnoví vykonávanie v tomto bode s výsledkom val, pričom 0 nahradí hodnotou 1; k svojmu volajúcemu sa nikdy nevráti.
Celý riadiaci výraz príkazu výberu alebo cyklu môže tvoriť samotné volanie setjmp, jeho logická negácia (!) alebo porovnanie relačným operátorom či operátorom rovnosti alebo nerovnosti, v ktorom je jedným operandom volanie a druhým celočíselný konštantný výraz. Volanie setjmp, prípadne explicitne pretypované na void, môže tvoriť aj celý výraz výrazového príkazu. Nepoužívajte setjmp ako podmienku operátora ?:. Inicializácia int r = setjmp(env); spôsobuje nedefinované správanie.
Cieľ musí byť stále aktívny v tom istom vlákne; nikdy neskáčte do ukončenej funkcie ani do opusteného rozsahu typu s variabilnou modifikáciou. Automatické lokálne objekty cieľovej funkcie bez volatile, ktoré sa od uloženia prostredia zmenili, majú neurčitú reprezentáciu. Skok preskočí čistiaci kód, neuvoľní prostriedky a neobnoví stav súborov ani prostredia s pohyblivou rádovou čiarkou.
Príklady
#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;
}
Výsledok
before recovered
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.