База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

raise — генериране на сигнал

raise(sig) задейства обработката на сигнала според текущата настройка; не регистрира обработчик.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

#include <signal.h>
int raise(int sig);

raise(sig) от <signal.h> генерира сигнал. signal определя реакцията: обработчик, SIG_IGN (игнориране) или SIG_DFL (поведение по подразбиране, зависещо от реализацията).

Резултатът е 0 при успех и ненулева стойност при неуспех. Ако обработчикът бъде извикан и се върне, raise се връща едва след това; прекратяването на програмата може да попречи на връщането.

Според N3096 обработчик, извикан от raise, не трябва да извиква raise. Връщането от обработчик за SIGFPE, SIGILL или SIGSEGV води до неопределено поведение. Използването на signal в многонишкова програма също е неопределено.

Примерът използва SIGTERM; обработчикът само присвоява стойност на volatile sig_atomic_t. Отпечатването става след това.

Примери

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

Резултат

Signal handled

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници