CKTIS / C
atexit — funkcja biblioteki C23
`atexit(void (*func)(void))` z `<stdlib.h>` rejestruje bezargumentową funkcję wywoływaną przy normalnym zakończeniu programu. Zwraca zero przy sukcesie, a wartość niezerową, gdy rejestracja się nie powiedzie.
Wersja: C23
Składnia
int atexit(void (*func)(void));atexit(void (*func)(void)) z <stdlib.h> rejestruje bezargumentową funkcję wywoływaną przy normalnym zakończeniu programu. Zwraca zero przy sukcesie, a wartość niezerową, gdy rejestracja się nie powiedzie.
Służy do końcowego zwalniania zasobów procesu, których nie da się wygodnie objąć lokalną kontrolą przepływu. Przykład rejestruje dwie różne procedury, sprawdza oba wyniki i pozwala, by powrót z main uruchomił je jako second, potem first.
Implementacja musi obsłużyć co najmniej 32 rejestracje, a każde udane zarejestrowanie — także tej samej funkcji wielokrotnie — tworzy osobne wywołanie. Zwykle obowiązuje kolejność odwrotna, z wyjątkiem procedury dodanej już podczas kończenia: jest ona wywoływana po wcześniej zarejestrowanych procedurach, które w chwili jej dodania już zostały wywołane. Wyjście z procedury przez longjmp ma niezdefiniowane zachowanie; abort, _Exit i quick_exit tych procedur nie uruchamiają.
Przykłady
#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;
}
Wynik
body second first
Służy do końcowego zwalniania zasobów procesu, których nie da się wygodnie objąć lokalną kontrolą przepływu. Przykład rejestruje dwie różne procedury, sprawdza oba wyniki i pozwala, by powrót z `main` uruchomił je jako `second`, potem `first`.