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.