std:: at_quick_exit
|
|
Program termination | ||||||||||||||||||||||||||||||||||||
|
|
|||||||||||||||||||||||||||||||||||
Unreachable control flow | ||||||||||||||||||||||||||||||||||||
(C++23)
|
||||||||||||||||||||||||||||||||||||
Communicating with the environment | ||||||||||||||||||||||||||||||||||||
Signals | ||||||||||||||||||||||||||||||||||||
Signal types | ||||||||||||||||||||||||||||||||||||
Non-local jumps | ||||||||||||||||||||||||||||||||||||
Types | ||||||||||||||||||||||||||||||||||||
Defined in header
<cstdlib>
|
||
int
at_quick_exit
(
/*atexit-handler*/
*
func
)
noexcept
;
int at_quick_exit ( /*c-atexit-handler*/ * func ) noexcept ; |
(1) | (since C++11) |
extern
"C++"
using
/*atexit-handler*/
=
void
(
)
;
extern "C" using /*c-atexit-handler*/ = void ( ) ; |
(2) | ( exposition only* ) |
Registers the function pointed to by
func
to be called on quick program termination (via
std::quick_exit
).
Calling the function from several threads does not induce a data race. The implementation is guaranteed to support the registration of at least 32 functions. The exact limit is implementation-defined.
The registered functions will not be called on normal program termination . If a function need to be called in that case, std::atexit must be used.
Parameters
func | - | pointer to a function to be called on quick program termination |
Return value
0 if the registration succeeds, nonzero value otherwise.
Notes
The two overloads are distinct because the types of the parameter
func
are distinct (
language linkage
is part of its type).
Example
#include <cstdlib> #include <iostream> void f1() { std::cout << "pushed first" << std::endl; // flush is intentional } extern "C" void f2() { std::cout << "pushed second\n"; } int main() { auto f3 = [] { std::cout << "pushed third\n"; }; std::at_quick_exit(f1); std::at_quick_exit(f2); std::at_quick_exit(f3); std::quick_exit(0); }
Output:
pushed third pushed second pushed first
See also
causes abnormal program termination (without cleaning up)
(function) |
|
causes normal program termination with cleaning up
(function) |
|
registers a function to be called on
std::exit()
invocation
(function) |
|
(C++11)
|
causes quick program termination without completely cleaning up
(function) |
C documentation
for
at_quick_exit
|