CKTIS / C
raise — sprožitev signala
raise(sig) sproži obravnavo signala glede na trenutno nastavitev; ne registrira obravnavne funkcije.
Različica: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <signal.h>
int raise(int sig);raise(sig) iz <signal.h> sproži signal. Funkcija signal določi odziv: obravnavno funkcijo, SIG_IGN (ignoriranje) ali SIG_DFL (privzeto vedenje, odvisno od implementacije).
Ob uspehu je rezultat 0, ob napaki pa vrednost, ki ni nič. Če je obravnavna funkcija poklicana in se vrne, se raise vrne šele za njo; končanje programa lahko vrnitev prepreči.
Po N3096 obravnavna funkcija, ki jo pokliče raise, ne sme poklicati raise. Vrnitev iz obravnavne funkcije za SIGFPE, SIGILL ali SIGSEGV povzroči nedefinirano vedenje. Tudi uporaba funkcije signal v večnitnem programu je nedefinirana.
Primer uporablja SIGTERM; obravnavna funkcija samo dodeli vrednost spremenljivki volatile sig_atomic_t. Izpis se izvede pozneje.
Primeri
#include <signal.h>
#include <stdio.h>
#include <stdlib.h>
static volatile sig_atomic_t received = 0;
static void handle_signal(int sig)
{
(void)sig;
received = 1;
}
int main(void)
{
if (signal(SIGTERM, handle_signal) == SIG_ERR) {
return EXIT_FAILURE;
}
if (raise(SIGTERM) != 0) {
return EXIT_FAILURE;
}
if (received == 0) {
return EXIT_FAILURE;
}
puts("Signal handled");
return EXIT_SUCCESS;
}Rezultat
Signal handled
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.