Defined in header
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.
|sig||-|| the signal to set the signal handler to. It can be an implementation-defined value or one of the following values:
|handler||-|| the signal handler. This must be one of the following:
 Return value
Previous signal handler on success or SIG_ERR on failure (setting a signal handler can be disabled on some implementations).
 Signal handler
The following limitations are imposed on the user-defined function that is installed as a signal handle
- the signal handler calls any function within the standard library, except abort, _Exit, quick_exit, or signal with the first argument not being the number of the signal currently handled.
- the signal handler refers to any object with static or thread-local(since C11) storage duration that is not lock-free atomic(since C++11) or volatile std::sig_atomic_t.
On entry to the signal handler, the state of the floating-point environment and the values of all objects is unspecified, except for
- objects of type volatile sig_atomic_t
- objects of lock-free atomic types (since C11)
- side effects made visible through atomic_signal_fence (since C11)
On return from a signal handler, the value of any object modified by the signal handler that is not volatile sig_atomic_t or lock-free atomic(since C11) is undefined.
The behavior is undefined if signal is used in a multithreaded program. It is not required to be thread-safe.
POSIX requires that
signal is thread-safe, and specifies a list of async-signal-safe library functions that may be called from any signal handler.
|This section is incomplete|
Reason: no example
 See also
| runs the signal handler for particular signal |
C++ documentation for signal