Namespaces
Variants
Views
Actions

std::signal

From cppreference.com
< cpp‎ | utility‎ | program
Revision as of 12:18, 2 November 2012 by P12bot (Talk | contribs)

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 std::signal(sig, SIG_DFL) will be executed immediately before the start of signal handler. Also, the implementation can prevent some implementation-defined set of signals from occurring while the signal handler runs.

For some of the signals, the implementation may call std::signal(sig, SIG_IGN) at the startup of the program. For the rest, the implementation must call std::signal(sig, SIG_DFL).

If the user defined function returns when handling Template:rlpt, Template:rlpt, Template:rlpt or any other implementation-defined signal specifying a computational exception, the behavior is undefined. In most implementations the program terminates.

If the signal handler is called as a result of std::abort or std::raise, the behavior is undefined if any of the following requirements is not followed:

  • the signal handler calls std::raise.
  • the signal handler refers to an object of static storage duration which is not declared as volatile std::sig_atomic_t.
  • the signal handler calls any function within the standard library, except std::abort, std::_Exit, or std::signal with the first argument not being the number of the signal currently handled.

Contents

Parameters

sig - the signal to set the signal handler to. It can be an implementation-defined value or one of the following values:
defines signal types
(macro constant) [edit]


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);


Return value

Previous signal handler on success or Template:rlpt on failure (setting a signal handler can be disabled on some implementations).

Example

See also

runs the signal handler for particular signal
(function) [edit]
C documentation for signal