atexit

Nach oben zu Stdlib.h - Index

Header-Datei

stdlib.h

Kategorie

Prozesssteuerungsroutinen

Prototyp

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

Beschreibung

Registriert eine Exit-Funktion.

atexit registriert die Funktion, auf die func zeigt, als Exit-Funktion. Bei normaler Beendigung des Programms ruft exit unmittelbar vor der Rückkehr zum Betriebssystem func auf. fcmp muss mit der Aufrufkonvention _USERENTRY deklariert werden.

Jeder Aufruf von atexit registriert eine weitere Exit-Funktion. Bis zu 32 Funktionen können registriert werden. Für die Ausführung gilt, dass die jeweils zuletzt registrierte Funktion als erste ausgeführt wird.

Rückgabewert

Wenn erfolgreich, gibt atexit 0 zurück, ansonsten einen Wert ungleich Null (für die Registrierung der Funktion ist kein Platz mehr verfügbar).

Beispiel

#include <stdio.h>
#include <stdlib.h>
void exit_fn1(void)
{
   printf("Exit function #1 called\n");
}
void exit_fn2(void)
{
   printf("Exit function #2 called\n");
}
int main(void)
{
   /* post exit function #1 */
   atexit(exit_fn1);
   /* post exit function #2 */
   atexit(exit_fn2);
   return 0;
}

Portabilität

POSIX	Win32	ANSI C	ANSI C++
+	+	+	+

Siehe auch

• atexit, #pragma exit, und Destruktoren