std::bad_alloc
From cppreference.com
| Defined in header <new>
|
||
| class bad_alloc; |
||
std::bad_alloc is the type of the object thrown as exceptions by the allocation functions to report failure to allocate storage.
Inheritance diagram
Contents |
[edit] Member functions
| (constructor) |
constructs the bad_alloc object (public member function) |
| operator= |
replaces a bad_alloc object (public member function) |
| what |
returns explanatory string (public member function) |
std::bad_alloc::bad_alloc
| bad_alloc(); |
||
Constructs new bad_alloc object with an implementation-defined null-terminated byte string which is accessible through what().
Parameters
(none)
Exceptions
| (none) | (until C++11) |
| noexcept specification: noexcept |
(since C++11) |
std::bad_alloc::operator=
| bad_alloc& operator=( const bad_alloc& other ); |
||
Assigns the contents of other.
Parameters
| other | - | another exception object to assign |
Return value
*this
Exceptions
| (none) | (until C++11) |
| noexcept specification: noexcept |
(since C++11) |
std::bad_alloc::what
| virtual const char* what() const; |
||
Returns the explanatory string.
Parameters
(none)
Return value
Pointer to a null-terminated string with explanatory information.
Exceptions
| (none) | (until C++11) |
| noexcept specification: noexcept |
(since C++11) |
Inherited from std::exception
Member functions
| [virtual] |
destructs the exception object (virtual public member function of std::exception)
|
| [virtual] |
returns an explanatory string (virtual public member function of std::exception)
|
[edit] Example
Run this code
#include <iostream> #include <new> int main() { try { while (true) { new int[100000000ul]; } } catch (const std::bad_alloc& e) { std::cout << "Allocation failed: " << e.what() << '\n'; } }
Possible output:
Allocation failed: std::bad_alloc
[edit] See also
| allocation functions (function) |
