function
<cstdlib>
quick_exit
_Noreturn void quick_exit (int status);
[[noreturn]] void quick_exit (int status) noexcept;
Terminate calling process quick
Terminates the process normally by returning control to the host environment after calling all functions registered using at_quick_exit .
No additional cleanup tasks are performed: No object destructors are called. Although whether C streams are closed and/or flushed, and files open with tmpfile are removed depends on the particular system or library implementation.
If status is zero or EXIT_SUCCESS , a successful termination status is returned to the host environment.
If status is EXIT_FAILURE , an unsuccessful termination status is returned to the host environment.
Otherwise, the status returned depends on the system and library implementation.
If a program calls both exit and quick_exit, or quick_exit more than once, it causes undefined behavior.
Parameters
- status
- Status code.
If this is 0 or EXIT_SUCCESS , it indicates success.
If it is EXIT_FAILURE , it indicates failure.
Return Value
none (the function never returns).
Example
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
/* quick_exit example */
#include <stdio.h> /* puts */
#include <stdlib.h> /* at_quick_exit, quick_exit, EXIT_SUCCESS */
void fnQExit (void)
{
puts ("Quick exit function.");
}
int main ()
{
at_quick_exit (fnQExit);
puts ("Main function: Beginning");
quick_exit (EXIT_SUCCESS);
puts ("Main function: End"); // never executed
return 0;
}
Output:
Main function: Beginning
Quick exit function.
Data races
Concurrently calling this function multiple times has no effect.
Calls to at_quick_exit that do not complete before the call to this function may not succeed (depends on particular library implementation).
Exceptions (C++)
No-throw guarantee: this function never throws exceptions.
If any of the functions registered with at_quick_exit throws an exception, terminate is automatically called.
See also
- at_quick_exit
- Set function to be executed on quick exit (function)
- exit
- Terminate calling process (function)
- abort
- Abort current process (function)