Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

raise — vyvolanie signálu

raise(sig) vyvolá spracovanie signálu podľa aktuálneho nastavenia; neregistruje obslužnú funkciu.

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

Syntax

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

raise(sig) z <signal.h> vyvolá signál. Funkcia signal určuje reakciu: obslužnú funkciu, SIG_IGN (ignorovanie) alebo SIG_DFL (predvolené správanie závislé od implementácie).

Pri úspechu je výsledkom 0, pri neúspechu nenulová hodnota. Ak sa obslužná funkcia zavolá a vráti sa, raise sa vráti až potom; ukončenie programu môže návratu zabrániť.

Podľa N3096 obslužná funkcia vyvolaná funkciou raise nesmie volať raise. Návrat z obslužnej funkcie pre SIGFPE, SIGILL alebo SIGSEGV spôsobuje nedefinované správanie. Použitie funkcie signal vo viacvláknovom programe je tiež nedefinované.

Príklad používa SIGTERM; obslužná funkcia iba priradí hodnotu do volatile sig_atomic_t. Výpis sa vykoná až potom.

Prí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ýsledok

Signal handled

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje