Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje