Namespaces
Variants

std:: longjmp

From cppreference.net
Utilities library
ヘッダーで定義 <csetjmp>
void longjmp ( std:: jmp_buf env, int status ) ;
(C++17まで)
[ [ noreturn ] ] void longjmp ( std:: jmp_buf env, int status ) ;
(C++17から)

以前の setjmp 呼び出しによって保存された実行コンテキスト env をロードします。この関数は戻りません。制御は env を設定したマクロ setjmp の呼び出し元に転送されます。その setjmp はその後、 status として渡された値を返します。

setjmp を呼び出した関数が既に終了している場合、動作は未定義です(言い換えれば、コールスタックを遡るロングジャンプのみが許可されます)。

目次

C++における追加の制限

Cの longjmp に加えて、C++ std::longjmp はより制限された動作を持ちます。

std::longjmp throw で置き換え、 setjmp catch で置き換えた場合に、 いずれかの自動オブジェクトに対して 非自明なデストラクタ が呼び出される場合、そのような std::longjmp の動作は未定義です。

std::longjmp コルーチン 内で、 co_await 演算子が使用される可能性のある場所で呼び出された場合、動作は未定義です。

(C++20以降)

パラメータ

env - プログラムの実行状態を参照する変数。 setjmp によって保存されたもの
status - setjmp から返される値。 0 と等しい場合、 1 が代わりに使用される

戻り値

(なし)

注記

std::longjmp は、関数が意味のある値を返せない予期せぬエラー状態を処理するためにC言語で使用されるメカニズムです。C++では一般的にこの目的のために 例外処理 を使用します。

#include <array>
#include <cmath>
#include <csetjmp>
#include <cstdlib>
#include <format>
#include <iostream>
std::jmp_buf solver_error_handler;
std::array<double, 2> solve_quadratic_equation(double a, double b, double c)
{
    const double discriminant = b * b - 4.0 * a * c;
    if (discriminant < 0)
        std::longjmp(solver_error_handler, true); // エラーハンドラへジャンプ
    const double delta = std::sqrt(discriminant) / (2.0 * a);
    const double argmin = -b / (2.0 * a);
    return {argmin - delta, argmin + delta};
}
void show_quadratic_equation_solution(double a, double b, double c)
{
    std::cout << std::format("Solving {}x² + {}x + {} = 0...\n", a, b, c);
    auto [x_0, x_1] = solve_quadratic_equation(a, b, c);
    std::cout << std::format("x₁ = {}, x₂ = {}\n\n", x_0, x_1);
}
int main()
{
    if (setjmp(solver_error_handler))
    {
        // ソルバーのエラーハンドラ
        std::cout << "実数解なし\n";
        return EXIT_FAILURE;
    }
    for (auto [a, b, c] : {std::array{1, -3, 2}, {2, -3, -2}, {1, 2, 3}})
        show_quadratic_equation_solution(a, b, c);
    return EXIT_SUCCESS;
}

出力:

Solving 1x² + -3x + 2 = 0...
x₁ = 1, x₂ = 2
Solving 2x² + -3x + -2 = 0...
x₁ = -0.5, x₂ = 2
Solving 1x² + 2x + 3 = 0...
実数解なし

欠陥報告

以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

DR 適用対象 公開時の動作 正しい動作
LWG 619 C++98 C++における追加制限の文言が不明確であった 文言を改善
LWG 894 C++98 std::longjmp
throw で、 setjmp
catch で置き換えた際に
自動オブジェクトが破棄される場合、
動作は未定義であった
動作は非自明なデストラクタが
自動オブジェクトに対して呼び出される
場合にのみ未定義

関連項目

コンテキストを保存する
(関数マクロ)