KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

<setjmp.h> — niet-lokale sprongen

De header <setjmp.h> slaat een terugkeerpunt op en hervat de uitvoering daarvandaan vanuit een geneste aanroep. Dit vereist strikte controle over levensduren en resources.

Versie: 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> biedt het arraytype jmp_buf, de macro setjmp en de functie longjmp. In C23 heeft __STDC_VERSION_SETJMP_H__ de waarde 202311L. De declaratie van setjmp in de syntax is beschrijvend: declareer deze niet zelf en onderdruk de macro niet.

setjmp(env) slaat de aanroepomgeving op en geeft aanvankelijk 0 terug. longjmp(env, val) hervat de uitvoering op dat punt met resultaat val, waarbij 0 wordt vervangen door 1; de functie keert nooit terug naar haar aanroeper.

Een losse aanroep van setjmp, de logische negatie ervan (!) of een vergelijking met een relationele operator of gelijkheidsoperator waarbij de aanroep de ene operand is en een constante expressie van het gehele type de andere, moet de volledige besturingsexpressie van een selectie- of lusinstructie vormen. De aanroep mag ook de volledige expressie van een expressie-instructie vormen, eventueel met een expliciete cast naar void. Gebruik setjmp niet als voorwaarde van de operator ?:. De initialisatie int r = setjmp(env); veroorzaakt ongedefinieerd gedrag.

Het doel moet in dezelfde thread actief blijven; spring nooit naar een beëindigde functie of naar een verlaten scope van een variabel gewijzigd type. Automatische lokale objecten van de doelfunctie die niet volatile zijn en sinds het opslaan van de omgeving zijn gewijzigd, hebben een onbepaalde representatie. De sprong slaat opruimcode over, maakt geen resources vrij en herstelt noch de toestand van bestanden, noch die van de drijvendekommaomgeving.

Voorbeelden

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

Resultaat

before
recovered

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen