##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# std::raise

From cppreference.com
< cpp‎ | utility‎ | program

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:
SIGABRT SIGFPE SIGILL SIGINT SIGSEGV SIGTERM | defines signal types (macro constant) [edit]

### [edit] Return value

​0​ upon success, non-zero value on failure.

### [edit] Example

Run this code

    #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';
        std::raise(SIGTERM);
    }

Possible output:

    Sending signal 15
    Received signal 15

### [edit] See also

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

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=cpp/utility/program/raise&oldid=64230"