CKTIS / C
raise — generare un segnale
raise(sig) attiva la gestione del segnale secondo l’impostazione corrente; non registra un gestore.
Versione: C23; repository compiler flag, production runtime not attested
Sintassi
#include <signal.h>
int raise(int sig);raise(sig) di <signal.h> genera un segnale. signal determina la risposta: un gestore, SIG_IGN (ignorare) oppure SIG_DFL (comportamento predefinito definito dall’implementazione).
Il risultato è 0 in caso di successo e un valore diverso da zero in caso di errore. Se un gestore viene chiamato e ritorna, raise ritorna solo dopo; la terminazione del programma può impedirne il ritorno.
Secondo N3096, un gestore invocato da raise non deve chiamare raise. Ritornare da un gestore per SIGFPE, SIGILL o SIGSEGV causa un comportamento indefinito. Anche l’uso di signal in un programma multithread è indefinito.
L’esempio usa SIGTERM; il gestore si limita ad assegnare un valore a volatile sig_atomic_t. La stampa avviene in seguito.
Esempi
#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;
}Risultato
Signal handled
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.