_Noreturn function specifier (since C11) (deprecated in C23)

関数が呼び出し元に戻らないことを指定します。

、$タグ内のテキストは翻訳せず保持\; -\; C++関連の専門用語（Syntax、Explanation、Keywords、Standard\; library、Example、References、See\; also）は原文のまま保持\; -\; 数値、構造、フォーマットは完全に維持$

構文

説明

_Noreturn キーワードは関数宣言に現れ、その関数がreturn文の実行や関数本体の終端に到達することで戻らないことを指定します（ longjmp の実行によって戻る可能性はあります）。 _Noreturn で宣言された関数が戻った場合、動作は未定義です。これを検出できる場合、コンパイラ診断が推奨されます。

_Noreturn 指定子は同じ関数宣言内に複数回現れることがあり、その動作は1回現れた場合と同じです。

この指定子は通常、ヘッダー <stdnoreturn.h> で提供される便利マクロ noreturn を通じて使用されます。

キーワード

_Noreturn

標準ライブラリ

以下の関数は標準ライブラリにおいて noreturn です：

• abort()
• exit()
• _Exit()
• quick_exit()
• thrd_exit()
• longjmp()

例

#include <stdio.h>
#include <stdlib.h>
#include <stdnoreturn.h>
// i <= 0 の場合、未定義動作を引き起こす
// i > 0 の場合、終了する
noreturn void exit_now(int i) // or _Noreturn void exit_now(int i)
{
    if (i > 0)
        exit(i);
}
int main(void)
{
    puts("Preparing to exit...");
    exit_now(2);
    puts("This code is never executed.");
}

Preparing to exit...

参考文献

関連項目