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)
  {
     /* Exit-Funktion 1 registrieren */
     atexit(exit_fn1);
     /* Exit-Funktion 2 registrieren */
     atexit(exit_fn2);
     return 0;
  }

Portabilität

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

Siehe auch

• atexit, #pragma exit, und Destruktoren