std::abort

 

C++

Language

Standard library headers

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

 

Utilities library

Type support (basic types, RTTI, type traits)

Dynamic memory management

Error handling

Program utilities

Variadic functions

Date and time

Function objects

initializer_list (C++11)

bitset

hash (C++11)

Relational operators

rel_ops::operator!=rel_ops::operator>rel_ops::operator<=rel_ops::operator>=

Pairs and tuples

pair

tuple (C++11)

piecewise_construct_t (C++11)

piecewise_construct (C++11)

Swap, forward and move

swap

forward (C++11)

move (C++11)

move_if_noexcept (C++11)

declval (C++11)

 

Program support utilities

Program termination
abort exit quick_exit (C++11) _Exit (C++11)	atexit at_quick_exit (C++11) EXIT_SUCCESSEXIT_FAILURE
Communicating with the environment
system	getenv
Signals
signal raise sig_atomic_t	SIG_DFLSIG_IGN SIG_ERR
Signal types
SIGABRTSIGFPESIGILLSIGINTSIGSEGVSIGTERM
Non-local jumps
setjmp
longjmp
Types
jmp_buf

 

Defined in header <cstdlib>
void abort();		(until C++11)
[[noreturn]] void abort();		(since C++11)

Causes abnormal program termination unless SIGABRT is being caught by a signal handler passed to signal and the handler does not return.

Destructors of variables with automatic, thread local and static storage durations are not called. Functions passed to std::atexit() are also not called. Whether open resources such as files are closed is implementation defined. Implementation defined status is returned to the host environment that indicates unsuccessful execution.

Parameters

(none)

Return value

(none)

Exceptions

(none)	(until C++11)
noexcept specification:   noexcept	(since C++11)

Example

Run this code

#include <cassert> // assert
#include <csignal> // std::signal
#include <iostream> // std::cout
 
class Tester {
 public:
  Tester() {
    std::cout << "Tester ctor\n";
  }
 
  ~Tester() {
    std::cout << "Tester dtor\n";
  }
};
 
// Destructor not called
Tester static_tester;
 
void signal_handler(int signal) {
  if (signal == SIGABRT) {
    std::cerr << "SIGABRT received\n";
  }
  else {
    std::cerr << "Unexpected signal " << signal << " received\n";
  }
  std::_Exit(EXIT_FAILURE);
}
 
int main() {
  // Destructor not called
  Tester automatic_tester;
 
  // Setup handler
  const auto previous_handler = std::signal(SIGABRT, signal_handler);
  if (previous_handler == SIG_ERR) {
    std::cerr << "Setup failed\n";
    return EXIT_FAILURE;
  }
 
  // Raise SIGABRT
  assert(false);
 
  std::cout << "This code is unreachable\n";
  return EXIT_SUCCESS;
}

Output:

Tester ctor
Tester ctor
Assertion failed: (false), function main, file ..., line 41.
SIGABRT received

See also

exit	causes normal program termination with cleaning up (function)
atexit	registers a function to be called on std::exit() invocation (function)
quick_exit (C++11)	causes normal program termination without completely cleaning up (function)
signal	sets a signal handler for particular signal (function)
C documentation for abort