std::signal

From Cppreference

C++ Standard Library
Language Utilities library Strings library Containers library Algorithms library Iterators library Numerics library Input/output library Localizations library Regular expressions library (C++11) Atomic operations library (C++11) Thread support library (C++11)
Utilities library
Program support utilities
Program termination abort exit quick_exit (C++11) _Exit (C++11) atexit at_quick_exit (C++11) Execution outcome indicators EXIT_SUCCESS EXIT_FAILURE Communicating with the environment system getenv Signals signal raise Signal handling strategies SIG_DFL SIG_IGN SIG_ERR Signal types SIGABRT SIGFPE SIGILL SIGINT SIGSEGV SIGTERM Non-local jumps setjmp longjmp Types jmp_buf

Defined in header <csignal>
void (*signal( int sig, void (*handler) (int))) (int);

Sets the error handler for signal sig. The signal handler can be set so that default handling will occur, signal is ignored, or an user-defined function is called.

When signal handler is set to a function and a signal occurs, it is implementation defined whether signal(sig, SIG_DFL) will be executed immediately before the start of signal handler. Also, the implementation can prevent some implementation-defined set af signals from occurring while the signal handler runs.

If the user defined function returns when handling SIGFPE, SIGILL or SIGSEGV, the behavior is undefined. In most implementations the program terminates.

Contents 1 Parameters 2 Return value 3 Example 4 See also

[edit] Parameters

sig	-	the signal to set the signal handler to. It can be an implementation-defined value or one of the following values: SIGABRT abnormal termination (macro constant) SIGFPE floating point exception (macro constant) SIGILL invalid instruction (macro constant) SIGINT interactive attention request sent to the program (macro constant) SIGSEGV invalid memory access (macro constant) SIGTERM termination request sent to the program (macro constant)
handler	-	the signal handler. This must be one of the following: SIG_DFL macro. The signal handler is set to default signal handler. SIG_IGN macro. The signal is ignored. pointer to a function. The signature of the function must be equivalent to the following: void fun(int sig);

[edit] Return value

previous signal handler on success or SIG_ERR on failure (setting a signal handler can be disabled on some implementations).

[edit] Example

This section is incomplete

[edit] See also

raise	runs the signal handler for particular signal (function)