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

CKTIS / C

atexit — knihovní funkce C23

`atexit(void (*func)(void))` z `<stdlib.h>` registruje bezargumentovou funkci volanou při normálním ukončení programu. Vrací nulu při úspěchu a nenulovou hodnotu, pokud registrace selže.

Verze: C23

Syntaxe

int atexit(void (*func)(void));

atexit(void (*func)(void)) z <stdlib.h> registruje bezargumentovou funkci volanou při normálním ukončení programu. Vrací nulu při úspěchu a nenulovou hodnotu, pokud registrace selže.

Hodí se pro závěrečný úklid prostředků procesu, který nelze pohodlně vést místním tokem řízení. Příklad registruje dvě různé obsluhy, ověří oba výsledky a nechá návrat z main zavolat second a potom first.

Implementace musí podporovat nejméně 32 registrací a každá úspěšná registrace, i opakovaná pro tutéž funkci, vytvoří jedno volání. Obvykle platí opačné pořadí, avšak obsluha přidaná během ukončování se zavolá po dříve registrovaných obsluhách, které již byly při jejím přidání zavolány. Opuštění přes longjmp má nedefinované chování; abort, _Exit a quick_exit tyto obsluhy nespouštějí.

Příklady

#include <stdio.h>
#include <stdlib.h>

static void first(void) { puts("first"); }
static void second(void) { puts("second"); }

int main(void) {
    if (atexit(first) != 0 || atexit(second) != 0) return EXIT_FAILURE;
    puts("body");
    return EXIT_SUCCESS;
}

Výsledek

body
second
first

Hodí se pro závěrečný úklid prostředků procesu, který nelze pohodlně vést místním tokem řízení. Příklad registruje dvě různé obsluhy, ověří oba výsledky a nechá návrat z `main` zavolat `second` a potom `first`.

Zdroje