Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

<setjmp.h> — saltos não locais

O cabeçalho <setjmp.h> guarda um ponto de retorno e retoma a execução nesse ponto a partir de uma chamada aninhada. Exige um controlo rigoroso dos tempos de vida e dos recursos.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

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

<setjmp.h> disponibiliza o tipo array jmp_buf, a macro setjmp e a função longjmp. Em C23, __STDC_VERSION_SETJMP_H__ tem o valor 202311L. A declaração de setjmp apresentada na sintaxe é descritiva: não a declares por iniciativa própria nem suprimas a macro.

setjmp(env) guarda o ambiente de chamada e, inicialmente, devolve 0. longjmp(env, val) retoma a execução nesse ponto com o resultado val, substituindo 0 por 1; nunca regressa ao seu chamador.

A chamada a setjmp por si só, a sua negação lógica (!) ou uma comparação relacional ou de igualdade em que um operando é a chamada e o outro é uma expressão constante inteira tem de constituir toda a expressão de controlo de uma instrução de seleção ou de iteração. Em alternativa, a chamada, com ou sem conversão explícita para void, pode constituir toda a expressão de uma instrução de expressão. Não uses setjmp como condição do operador ?:. A inicialização int r = setjmp(env); causa comportamento indefinido.

O destino tem de continuar ativo na mesma thread; nunca saltes para uma função terminada nem para um âmbito já abandonado de um tipo modificado variavelmente. Os objetos locais automáticos da função de destino que não sejam volatile e que tenham mudado desde que o ambiente foi guardado têm uma representação indeterminada. O salto ignora o código de limpeza, não liberta recursos nem restaura o estado dos ficheiros ou do ambiente de vírgula flutuante.

Exemplos

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

Resultado

before
recovered

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes