std::raise(3)

🌸 NAME 🌸

std::raise - std::raise — yes bestie, the function is so nice they named it twice ✨. This page comes from the C++ Standard Libary (and yes, the header really spells it like that — iconic typo, no notes 💀), and we’re about to send some signals, okay? 💅

🦋 Synopsis 🦋

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

Sends signal sig to the program. The signal handler — the one you specify with the std::signal() function — gets invoked. 🫶

If you haven’t set a user-defined signal handling strategy using std::signal() yet, it is implementation-defined whether the signal will be ignored or the default handler will be invoked. Like, the standard is literally not promising you which one, so don’t act surprised 😭.

💅 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

These are macro constants that define signal types. Slay, constants 💖.

✨ Return value ✨

0 upon success, non-zero value on failure. That’s it, that’s the vibe check 🔥.

🌈 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

🎀 See also 🎀

• signal — sets a signal handler for particular signal (function)
• C documentation for raise

source: http://cppreference.com · version/date: 2024.06.10 · std::raise(3) signing off, love u bestie 💖🫶🎀