Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

raise — vyvolání signálu

raise(sig) vyvolá zpracování signálu podle aktuálního nastavení; neregistruje obslužnou funkci.

Verze: C23; repository compiler flag, production runtime not attested

Syntaxe

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

raise(sig) z <signal.h> vyvolá signál. Funkce signal určuje reakci: obslužnou funkci, SIG_IGN (ignorování) nebo SIG_DFL (výchozí chování závislé na implementaci).

Při úspěchu je výsledkem 0, při neúspěchu nenulová hodnota. Pokud je obslužná funkce zavolána a vrátí se, raise se vrátí až poté; ukončení programu může návratu zabránit.

Podle N3096 obslužná funkce vyvolaná funkcí raise nesmí volat raise. Návrat z obslužné funkce pro SIGFPE, SIGILL nebo SIGSEGV způsobuje nedefinované chování. Použití funkce signal ve vícevláknovém programu je rovněž nedefinované.

Příklad používá SIGTERM; obslužná funkce pouze přiřadí hodnotu do volatile sig_atomic_t. Výpis proběhne až poté.

Příklady

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

Výsledek

Signal handled

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje