raise

 

C

編譯器支援

語言

標頭檔案

型別支援

程式工具

變參函式支援

錯誤處理

動態記憶體管理

字串庫

演算法

數值

日期和時間工具

輸入/輸出支援

本地化支援

併發支援 (C11)

技術規範

符號索引

 

程式支援實用程式

程式終止
abort exit quick_exit (C11) _Exit (C99)	atexit at_quick_exit (C11) EXIT_SUCCESSEXIT_FAILURE
不可達控制流
unreachable (C23)
與環境通訊
getenvgetenv_s (C11)	system
記憶體對齊查詢
memalignment (C23)
訊號
signal raise sig_atomic_t	SIG_DFLSIG_IGN SIG_ERR
訊號型別
SIGABRTSIGFPESIGILL	SIGINTSIGSEGVSIGTERM
非區域性跳轉
setjmp	longjmp
型別
jmp_buf

 

定義於標頭檔案 <signal.h>
int raise( int sig );

傳送訊號 sig 給程式。將呼叫使用 signal() 指定的訊號處理程式。

如果尚未透過 signal() 設定使用者定義的訊號處理策略，則訊號是否被忽略或是否呼叫預設處理程式是實現定義的。

引數

sig

-

要傳送的訊號。它可以是實現定義的值或以下值之一 SIGABRTSIGFPESIGILLSIGINTSIGSEGVSIGTERM 定義訊號型別 (宏常量)

返回值

成功時返回 ​0​，失敗時返回非零值。

示例

執行此程式碼

#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");
}

輸出

Sending signal 15
Received signal 15
Exit main()

參考

• C17 標準 (ISO/IEC 9899:2018)

• 7.14.2.1 The raise function (p: 194-195)

• C11 標準 (ISO/IEC 9899:2011)

• 7.14.2.1 The raise function (p: 267)

• C99 標準 (ISO/IEC 9899:1999)

• 7.14.2.1 The raise function (p: 248)

• C89/C90 標準 (ISO/IEC 9899:1990)

• 4.7.2.1 The raise function

另請參閱

signal	為特定訊號設定訊號處理程式 (函式)
C++ 文件，關於 raise