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

CKTIS / C

longjmp — função de transferência de controlo C23

`longjmp(env, val)` de `<setjmp.h>` restaura o ambiente guardado pelo último `setjmp(env)` e não volta ao ponto de chamada. O `setjmp` retomado devolve `val`, ou `1` se `val == 0`, distinguindo o salto da passagem inicial.

Versão: C23

Sintaxe

[[noreturn]] void longjmp(jmp_buf env, int val);

longjmp(env, val) de <setjmp.h> restaura o ambiente guardado pelo último setjmp(env) e não volta ao ponto de chamada. O setjmp retomado devolve val, ou 1 se val == 0, distinguindo o salto da passagem inicial.

O exemplo guarda um jmp_buf de âmbito de ficheiro; após o zero inicial chama um auxiliar que executa longjmp(environment, 42). A saída 42 prova transferência não local real, não simulada com return.

A função que executou setjmp tem de continuar ativa e o salto permanecer na mesma thread; caso contrário o comportamento é indefinido. Os seus objetos automáticos não volatile alterados após setjmp têm valores indeterminados. Saltar para ambiente guardado no âmbito abandonado de objeto com tipo variavelmente modificado também é UB. longjmp não liberta recursos e ignora limpeza normal.

Exemplos

#include <setjmp.h>
#include <stdio.h>
static jmp_buf environment;
static void finish(void){longjmp(environment,42);}
int main(void){int value=setjmp(environment);if(value==0)finish();printf("%d\n",value);return 0;}

Resultado

42

O exemplo guarda um `jmp_buf` de âmbito de ficheiro; após o zero inicial chama um auxiliar que executa `longjmp(environment, 42)`. A saída `42` prova transferência não local real, não simulada com `return`.

Fontes