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

CKTIS / C

setjmp — guardar um ambiente de chamada

`setjmp` guarda um ambiente em `jmp_buf`, permitindo retomar posteriormente a execução através de `longjmp`.

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

Sintaxe

#include <setjmp.h>
int setjmp(jmp_buf env);

setjmp de <setjmp.h> é descrita como uma macro, não como uma função normal. Inicialmente, devolve 0; depois de longjmp(env, value), devolve value, substituindo 0 por 1.

Uma invocação de setjmp pode constituir toda a expressão de controlo de uma instrução de seleção ou de iteração. Pode também ser o operando do operador unário ! ou um dos operandos de um operador relacional ou de igualdade cujo outro operando seja uma expressão constante inteira. Nestes dois últimos casos, a expressão resultante tem de constituir toda a expressão de controlo de uma instrução de seleção ou de iteração. A invocação pode também constituir toda a expressão de uma instrução de expressão, com ou sem conversão explícita para void. Qualquer outro contexto provoca comportamento indefinido. Isto inclui int result = setjmp(env); e a utilização da invocação como expressão de controlo de uma seleção genérica _Generic, embora essa expressão não seja avaliada.

O destino tem de continuar ativo na mesma thread. Os objetos locais automáticos modificados e sem volatile na função que guarda o ambiente tornam-se indeterminados. Um salto não desfaz operações de entrada/saída.

Exemplos

#include <setjmp.h>
#include <stdio.h>

int main(void)
{
    jmp_buf env;
    if (setjmp(env) == 0) {
        longjmp(env, 1);
    } else {
        puts("resumed");
    }
    return 0;
}

Resultado

resumed

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