CKTIS / C
atexit — C23-Bibliotheksfunktion
`atexit(void (*func)(void))` aus `<stdlib.h>` registriert eine argumentlose Funktion für die normale Programmbeendigung. Sie liefert null bei Erfolg und einen von null verschiedenen Wert, wenn die Registrierung scheitert.
Version: C23
Syntax
int atexit(void (*func)(void));atexit(void (*func)(void)) aus <stdlib.h> registriert eine argumentlose Funktion für die normale Programmbeendigung. Sie liefert null bei Erfolg und einen von null verschiedenen Wert, wenn die Registrierung scheitert.
Sie eignet sich für abschließendes Aufräumen von Prozessressourcen, das nicht bequem dem lokalen Kontrollfluss folgen kann. Das Beispiel registriert zwei verschiedene Handler, prüft beide Ergebnisse und lässt die Rückkehr aus main zuerst second, dann first aufrufen.
Eine Implementierung muss mindestens 32 Registrierungen unterstützen; jede erfolgreiche Registrierung, auch derselben Funktion mehrfach, erzeugt einen Aufruf. Normalerweise gilt umgekehrte Reihenfolge; ein erst während der Beendigung registrierter Handler wird jedoch nach allen zuvor registrierten Handlern aufgerufen, die bei seiner Registrierung bereits gelaufen waren. Das Verlassen per longjmp ist undefiniert; abort, _Exit und quick_exit führen diese Handler nicht aus.
Beispiele
#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;
}
Ergebnis
body second first
Sie eignet sich für abschließendes Aufräumen von Prozessressourcen, das nicht bequem dem lokalen Kontrollfluss folgen kann. Das Beispiel registriert zwei verschiedene Handler, prüft beide Ergebnisse und lässt die Rückkehr aus `main` zuerst `second`, dann `first` aufrufen.