Namespaces
Variants
Actions

raise

From cppreference.com
< c‎ | program
 
C
 
Program support utilities
Program termination
Unreachable control flow
(C23)
Communicating with the environment
Memory alignment query
(C23)
Signals
Signal types
Non-local jumps
Types
 
Defined in header <signal.h>
int raise( int sig );

Sends signal sig to the program. The signal handler, specified using signal(), is invoked.

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

Contents

[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

Run this code
#include <signal.h>
#include <stdio.h>
 
void signal_handler(int signal)
{
    printf("Received signal %d\n", signal);
}
 
int main(void)
{
    / Install a signal handler.
    signal(SIGTERM, signal_handler);
 
    printf("Sending signal %d\n", SIGTERM);
    raise(SIGTERM);
    printf("Exit main()\n");
}

Output: 

Sending signal 15
Received signal 15
Exit main()

[edit] References

  • C17 standard (ISO/IEC 9899:2018):
  • 7.14.2.1 The raise function (p: 194-195)
  • C11 standard (ISO/IEC 9899:2011):
  • 7.14.2.1 The raise function (p: 267)
  • C99 standard (ISO/IEC 9899:1999):
  • 7.14.2.1 The raise function (p: 248)
  • C89/C90 standard (ISO/IEC 9899:1990):
  • 4.7.2.1 The raise function

[edit] See also

 sets a signal handler for particular signal
(function) [edit]
C++ documentation for raise
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=c/program/raise&oldid=140326"

Follow Lee on X/Twitter - Father, Husband, Serial builder creating AI, crypto, games & web tools. We are friends :) AI Will Come To Life!

Check out: eBank.nz (Art Generator) | Netwrck.com (AI Tools) | Text-Generator.io (AI API) | BitBank.nz (Crypto AI) | ReadingTime (Kids Reading) | RewordGame | BigMultiplayerChess | WebFiddle | How.nz | Helix AI Assistant