CKTIS / C
<setjmp.h> — nelokální skoky
Hlavička <setjmp.h> uloží návratový bod a umožní pokračovat v provádění od něj z vnořeného volání. Vyžaduje přísnou kontrolu životnosti a prostředků.
Verze: C23; repository compiler flag, production runtime not attested
Syntaxe
#include <setjmp.h>
jmp_buf env;
int setjmp(jmp_buf env);
[[noreturn]] void longjmp(jmp_buf env, int val);<setjmp.h> poskytuje typ pole jmp_buf, makro setjmp a funkci longjmp. V C23 má __STDC_VERSION_SETJMP_H__ hodnotu 202311L. Deklarace setjmp v syntaxi je pouze popisná: nedeklarujte ji sami a nepotlačujte její makro.
setjmp(env) uloží prostředí volání a zpočátku vrátí 0. longjmp(env, val) obnoví provádění v tomto bodě s výsledkem val, přičemž 0 nahradí hodnotou 1; ke svému volajícímu se nikdy nevrátí.
Celý řídicí výraz příkazu výběru nebo cyklu smí tvořit samotné volání setjmp, jeho logická negace (!) nebo porovnání relačním operátorem či operátorem rovnosti nebo nerovnosti, v němž je jedním operandem volání a druhým celočíselný konstantní výraz. Volání setjmp, případně explicitně přetypované na void, může také tvořit celý výraz výrazového příkazu. Nepoužívejte setjmp jako podmínku operátoru ?:. Inicializace int r = setjmp(env); způsobuje nedefinované chování.
Cíl musí být stále aktivní ve stejném vlákně; nikdy neskákejte do ukončené funkce ani do opuštěného rozsahu typu s proměnnou modifikací. Automatické lokální objekty cílové funkce bez volatile, které se od uložení prostředí změnily, mají neurčitou reprezentaci. Skok přeskočí úklidový kód, neuvolní prostředky a neobnoví stav souborů ani prostředí plovoucí čárky.
Pří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ýsledek
before recovered
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.