longjmp

同じプログラム中の最後に呼び出された setjmp マクロによって保存された環境を復元します．

#include <setjmp.h>

void longjmp(
    jmp_buf env,
    int val
);

longjmp 関数は，同じプログラム中で対応する jmp_buf 型の引数をもって最後に呼び出された setjmp マクロによって保存された環境を復元します．

longjmp が完了すると，対応する setjmp が引数 val で指定された値を返したものとしてプログラムを続行します． ただし，setjmp に 0 を返させることはできません． (引数 val に 0 を指定した場合は 1 を返します)


以下の場合の動作は未定義です．

  • longjmp が呼び出される前に，setjmp が呼び出されていない場合
  • setjmp の呼び出しを含む関数が実行を既に終了している場合
  • setjmp の呼出しが可変修飾型をもつ識別子の有効範囲内にあり，実行が途中でその有効範囲から離れた場合

C言語サンプルプログラム

以下に longjmp 関数を使用したサンプルプログラムを示します．

/* header files */
#include <stdio.h>
#include <stdlib.h>
#include <setjmp.h>

/* main */
int main(void) {
    jmp_buf env;
    int retVal = 0;

    /* jmp_bufに実行コンテキストを保存 */
    if ( (retVal = setjmp(env)) == 0 ) { /* :-) */
        printf("%d\n", retVal);

        /* :-) に復帰. 復帰後の setjmp は 1 を返す */
        longjmp(env, 1);

    } else {
        printf("%d\n", retVal);
        return EXIT_SUCCESS;

    }

    return EXIT_SUCCESS;
}

実行例

サンプルプログラムの実行結果は以下のようになります．

0
1