< cpp‎ | utility‎ | program
Utilities library
Language support
Type support (basic types, RTTI)
Library feature-test macros (C++20)
Dynamic memory management
Program utilities
Coroutine support (C++20)
Variadic functions
Debugging support
Three-way comparison
General utilities
Date and time
Function objects
Formatting library (C++20)
Relational operators (deprecated in C++20)
Integer comparison functions
Swap and type operations
Common vocabulary types
Elementary string conversions

Defined in header <csignal>
int raise( int sig );

Sends signal sig to the program. The signal handler (specified using the std::signal() function) is invoked.

If the user-defined signal handling strategy is not set using std::signal() yet, it is implementation-defined whether the signal will be ignored or default handler will be invoked.


[edit] Parameters

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

[edit] Return value

0 upon success, non-zero value on failure.

[edit] Example

#include <csignal>
#include <iostream>
void signal_handler(int signal)
    std::cout << "Received signal " << signal << '\n';
int main()
    // Install a signal handler
    std::signal(SIGTERM, signal_handler);
    std::cout << "Sending signal " << SIGTERM << '\n';

Possible output:

Sending signal 15
Received signal 15

[edit] See also

sets a signal handler for particular signal
(function) [edit]
C documentation for raise