std::signal

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ(C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ(C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

ファイルシステムライブラリ(C++17)

正規表現ライブラリ(C++11)

アトミック操作ライブラリ(C++11)

スレッドサポートライブラリ(C++11)

技術仕様書

 

ユーティリティライブラリ

言語サポート 型サポート (基本型、RTTI、型特性) ライブラリの機能テストマクロ (C++20) 動的メモリ管理 プログラムユーティリティ エラー処理 コルーチンサポート(C++20) 可変長引数関数 launder (C++17) initializer_list (C++11) source_location (C++20) 三方比較 (C++20) three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20) is_eqis_neqis_ltis_lteqis_gtis_gteq (C++20)(C++20)(C++20)(C++20)(C++20)(C++20)

汎用ユーティリティ 日付と時間 関数オブジェクト 書式化ライブラリ(C++20) bitset hash (C++11) integer_sequence (C++14) 関係演算子 (C++20で非推奨) rel_ops::operator!=rel_ops::operator>rel_ops::operator<=rel_ops::operator>= 整数比較関数 cmp_equalcmp_not_equalcmp_lesscmp_greatercmp_less_thancmp_greater_than (C++20)(C++20)(C++20)(C++20)(C++20)(C++20) in_range (C++20) スワップと型操作 swap ranges::swap (C++20) exchange (C++14) declval (C++11) forward (C++11) move (C++11) move_if_noexcept (C++11) as_const (C++17) 一般的な語彙の型 pair tuple (C++11) apply (C++17) make_from_tuple (C++17) optional (C++17) any (C++17) variant (C++17) 初等文字列変換 to_chars (C++17) from_chars (C++17) chars_format (C++17)

 

プログラムサポートユーティリティ

プログラム終了
abort exit quick_exit (C++11) _Exit (C++11)	atexit at_quick_exit (C++11) EXIT_SUCCESSEXIT_FAILURE
環境との通信
system	getenv
シグナル
signal raise sig_atomic_t	SIG_DFLSIG_IGN SIG_ERR
シグナルの種類
SIGABRTSIGFPESIGILLSIGINTSIGSEGVSIGTERM
非ローカルジャンプ
setjmp
longjmp
型
jmp_buf

 

ヘッダ <csignal> で定義
/*signal-handler*/* signal(int sig, /*signal-handler*/* handler);	(1)
extern"C"using/*signal-handler*/=void(int);// exposition-only	(2)

シグナル sig のためのハンドラを設定します。 シグナルハンドラは、デフォルトの処理を行う、シグナルを無視する、またはユーザ定義の関数が呼ばれるように設定することができます。

シグナルハンドラが関数に設定され、シグナルが発生したとき、シグナルハンドラの開始直前に std::signal(sig, SIG_DFL) が実行されるかどうかは処理系定義です。 また処理系は、シグナルハンドラを実行している間、処理系定義のシグナルの集合が発生しないように防ぐかもしれません。

いくつかのシグナルについては、処理系はプログラム開始時に std::signal(sig, SIG_IGN) を呼んでも構いません。 その他のシグナルについては、処理系は std::signal(sig, SIG_DFL) を呼ばなければなりません。

(ノート: POSIX はこれらの処理系定義の動作を標準化するための sigaction を導入しました)

引数

sig	-	シグナルハンドラを設定するシグナル。 処理系定義の値、または以下の値のいずれか。 SIGABRTSIGFPESIGILLSIGINTSIGSEGVSIGTERM シグナルの種類を定義します (マクロ定数)
handler	-	シグナルハンドラ。 以下のいずれかでなければなりません。 SIG_DFL マクロ。 シグナルハンドラはデフォルトのシグナルハンドラに設定されます。 SIG_IGN マクロ。 シグナルは無視されます。 関数へのポインタ。 関数のシグネチャは以下と同等でなければなりません。 extern"C"void fun(int sig);

戻り値

成功した場合は以前のシグナルハンドラ、失敗した場合は SIG_ERR (処理系によってはシグナルハンドラの設定は無効化されていることがあります)。

シグナルハンドラ

シグナルハンドラとしてインストールされるユーザ定義の関数には、以下の制限が課されます。

std::abort または std::raise の結果としてではなくシグナルハンドラが呼ばれた場合 (非同期シグナル)、以下は未定義動作となります。 シグナルハンドラが標準ライブラリ内の何らかの関数を呼ぶ。 ただし以下を除きます。 std::abort std::_Exit std::quick_exit 現在処理中のシグナル番号を第1引数に指定した std::signal (非同期ハンドラは自分自身を再登録することができますが、他のシグナルはできません)。 シグナルハンドラが std::atomic または(C++11以上)volatilestd::sig_atomic_t 以外の静的記憶域期間を持つオブジェクトを参照する。

(C++17未満)

任意のシグナルハンドラが以下のいずれかを行った場合、動作は未定義です。 以下のシグナルセーフな関数以外の、何らかのライブラリ関数を呼ぶ (特に、動的確保はシグナルセーフではないことに注意してください) std::atomic のメンバ関数および <atomic> の非メンバ関数、ただし操作対象のアトミック型がロックフリーな場合に限られます。 関数 std::atomic_is_lock_free および std::atomic::is_lock_free はいかなるアトミック型に対してもシグナルセーフです。 現在処理中のシグナル番号を第1引数に指定した std::signal (シグナルハンドラは自分自身を再登録することができますが、他のシグナルはできません)。 std::numeric_limits のメンバ関数。 std::_Exit std::abort std::quick_exit std::initializer_list のメンバ関数および std::begin と std::end の std::initializer_list オーバーロード。 std::forward, std::move, std::move_if_noexcept <type_traits> のすべての関数 std::memcpy および std::memmove スレッド記憶域期間を持つオブジェクトへのアクセス dynamic_cast 式 throw 式 try ブロックに入る。 関数 try ブロックも含みます。 動的非ローカル初期化を行う静的変数の初期化 (最初の ODR 使用まで遅延されているものも含みます) 別のスレッドが並行的に初期化している静的記憶域期間の任意の変数の初期化の完了を待つ

(C++17以上)

SIGFPE, SIGILL, SIGSEGV またはその他の計算上の例外を表す処理系定義のシグナルを処理するとき、ユーザ定義の関数が戻ると、動作は未定義です。

std::abort または std::raise の結果としてシグナルハンドラが呼ばれた場合 (同期シグナル)、シグナルハンドラが std::raise を呼ぶと、動作は未定義です。

シグナルハンドラの開始時、以下を除くすべてのオブジェクトの値および浮動小数点数環境の状態は未規定です。 volatilestd::sig_atomic_t 型のオブジェクト。 ロックフリーな std::atomic 型のオブジェクト。 std::atomic_signal_fence を通して可視となる副作用。 (C++11以上) シグナルハンドラから戻るとき、 volatilestd::sig_atomic_t またはロックフリーな std::atomic 以外の、シグナルハンドラで変更されたあらゆるオブジェクトの値は、不定になります。

(C++14未満)

関数 signal() の呼び出しは、あらゆるシグナルハンドラの呼び出しの結果に対して同期します。 std::raise の呼び出しの結果としてシグナルハンドラが (同期的に) 実行された場合、そのハンドラの実行は、 std::raise の呼び出しに対して後続配列され、その戻りに先行配列され、 std::raise と同じスレッドで実行されます。 他のシグナルに対するハンドラの実行は、プログラムの残りに対して配列されず、未規定のスレッドで実行されます。 volatilestd::sig_atomic_t 型の同じオブジェクトへの2つのアクセスは、両方が同じスレッドで行われれば、シグナルハンドラ内で行われても、データ競合を発生しません。 シグナルハンドラの各呼び出しについて、シグナルハンドラを呼び出すスレッドで行われる評価は、 A 内の評価に対して先行発生する評価が B になく、 そのような volatilestd::sig_atomic_t オブジェクトの評価がシグナルハンドラの実行に対して先行発生する A 内のすべての評価を通して値を取得し、シグナルハンドラの実行が B 内のすべての評価に対して先行発生するような、2つのグループ A と B に分割できます。

(C++14以上)

ノート

POSIX は、 signal がスレッドセーフであることを要求しており、任意のシグナルハンドラから呼ぶことができる非同期シグナルセーフなライブラリ関数の一覧を規定しています。

シグナルハンドラは、 C リンケージを持ち、一般的に、 C と C++ の共通のサブセットの機能のみを使用すると期待されています。 C++ リンケージを持つ関数がシグナルハンドラとして使用できるかどうかは処理系定義です。

例

Run this code

#include <csignal>#include <iostream>   namespace{volatilestd::sig_atomic_t gSignalStatus;}   void signal_handler(int signal){ gSignalStatus = signal;}   int main(){// Install a signal handler std::signal(SIGINT, signal_handler);   std::cout<<"SignalValue: "<< gSignalStatus <<'\n';std::cout<<"Sending signal "<<SIGINT<<'\n';std::raise(SIGINT);std::cout<<"SignalValue: "<< gSignalStatus <<'\n';}

出力例:

SignalValue: 0 Sending signal 2 SignalValue: 2

関連項目

raise	特定のシグナルに対するシグナルハンドラを実行します (関数)
atomic_signal_fence (C++11)	同じスレッドで実行されるシグナルハンドラとの間のフェンス (関数)
signal の C言語リファレンス