CKTIS / C
setjmp — enregistrer un environnement d’appel
`setjmp` enregistre un environnement dans `jmp_buf`, ce qui permet de reprendre l’exécution ultérieurement avec `longjmp`.
Version : C23; repository compiler flag, production runtime not attested
Syntaxe
#include <setjmp.h>
int setjmp(jmp_buf env);setjmp de <setjmp.h> est décrit comme une macro, et non comme une fonction ordinaire. Il renvoie initialement 0 ; après longjmp(env, value), il renvoie value, en remplaçant 0 par 1.
Un appel à setjmp peut constituer l’intégralité de l’expression de contrôle d’une instruction de sélection ou d’itération. Il peut aussi être l’opérande de l’opérateur unaire ! ou l’un des opérandes d’un opérateur relationnel ou d’égalité dont l’autre opérande est une expression constante entière. Dans ces deux derniers cas, l’expression résultante doit constituer toute l’expression de contrôle d’une instruction de sélection ou d’itération. L’appel peut aussi constituer toute l’expression d’une instruction-expression, avec ou sans conversion explicite en void. Tout autre contexte entraîne un comportement indéfini. C’est le cas de int result = setjmp(env); et de l’utilisation de l’appel comme expression de contrôle d’une sélection générique _Generic, même si cette expression n’est pas évaluée.
La cible doit rester active dans le même thread. Les objets locaux automatiques modifiés et dépourvus de volatile dans la fonction qui enregistre l’environnement deviennent indéterminés. Un saut n’annule pas les opérations d’entrée-sortie.
Exemples
#include <setjmp.h>
#include <stdio.h>
int main(void)
{
jmp_buf env;
if (setjmp(env) == 0) {
longjmp(env, 1);
} else {
puts("resumed");
}
return 0;
}
Résultat
resumed
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.