atexit

 

C

Language

Standard Library

Type support

Dynamic memory management

Error handling

Program utilities

Date and time utilities

Strings library

Algorithms

Numerics

Input/output support

Localization support

Thread support (C11)

Atomic operations (C11)

 

Program support utilities

Program termination
abort exit quick_exit (C++11) _Exit (C++11)	atexit at_quick_exit (C++11) EXIT_SUCCESS EXIT_FAILURE
Communicating with the environment
system	getenv
Signals
signal raise sig_atomic_t	SIG_DFL SIG_IGN SIG_ERR
Signal types
SIGABRT SIGFPE SIGILL SIGINT SIGSEGV SIGTERM
Non-local jumps
setjmp
longjmp
Types
jmp_buf

 

Defined in header <stdlib.h>
int atexit( void (*func)() );

Registers the function pointed to by func to be called on normal program termination (via exit() or returning from main()).

Calling the function from several threads does not induce a data race. The implementation shall support the registration of at least 32 functions.

Parameters

func

-

pointer to a function to be called on normal program termination

Return value

​0​ if the registration succeeds, nonzero value otherwise.

Exceptions

noexcept specification:  

noexcept

  (since C++11)

Example

run this code

#include <stdlib.h>
#include <stdio.h>
 
void f1()
{
    puts("pushed first");
}
 
void f2()
{
    puts("pushed second");
}
 
int main()
{
    atexit(f1);
    atexit(f2);
}

Output:

pushed second
pushed first

See also

at_quick_exit (C99)	registers a function to be called on quick_exit invocation (function)