# std::bad_alloc

> C++ Atlas: `cppatlas.com/w/cpp/memory/new/bad_alloc` | Source: https://en.cppreference.com/w/cpp/memory/new/bad_alloc | Domain: Memory management | Standards: C++11, C++26

std::bad_alloc is the type of the object thrown as exceptions by the allocation functions to report failure to allocate storage.

## Official Specification Summary (cppreference)

```cpp
// 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

#### Member functions

- (constructor): constructs a new `bad_alloc` object (public member function)
- `operator=`: replaces the `bad_alloc` object (public member function)
- `what`: returns the explanatory string (public member function)

### std::bad_alloc::bad_alloc

```cpp
bad_alloc() throw(); // (1) (until C++11)
bad_alloc() noexcept; // (1) (since C++11)
bad_alloc( const bad_alloc& other ) throw(); // (2) (until C++11)
bad_alloc( const bad_alloc& other ) noexcept; // (2) (since C++11)
```

Constructs a new `bad_alloc` object with an implementation-defined null-terminated byte string which is accessible through `what()`.

1) Default constructor.

2) Copy constructor. If `*this` and `other` both have dynamic type `std::bad_alloc` then `std::strcmp(what(), other.what()) == 0`. (since C++11)

#### Parameters

- `other` - another exception object to copy

### std::bad_alloc::operator=

```cpp
bad_alloc& operator=( const bad_alloc& other ) throw(); // (until C++11)
bad_alloc& operator=( const bad_alloc& other ) noexcept; // (since C++11)
```

Assigns the contents with those of `other`. If `*this` and `other` both have dynamic type `std::bad_alloc` then `std::strcmp(what(), other.what()) == 0` after assignment. (since C++11)

#### Parameters

- `other` - another exception object to assign with

#### Return value

`*this`

### std::bad_alloc::what

```cpp
virtual const char* what() const throw(); // (until C++11)
virtual const char* what() const noexcept; // (since C++11) (constexpr since C++26)
```

Returns the explanatory string.

#### Return value

Pointer to an implementation-defined null-terminated string with explanatory information. The string is suitable for conversion and display as a `std::wstring`. The pointer is guaranteed to be valid at least until the exception object from which it is obtained is destroyed, or until a non-const member function (e.g. copy assignment operator) on the exception object is called.

The returned string is encoded with the ordinary literal encoding during constant evaluation. (since C++26)

#### Notes

Implementations are allowed but not required to override `what()`.

### Inherited from std::exception

#### Member functions

- (destructor) [virtual]: destroys the exception object (virtual public member function of `std::exception`)
- `what` [virtual]: returns an explanatory string (virtual public member function of `std::exception`)

#### Notes

| Feature-test macro | Value | Std | Feature |
| --- | --- | --- | --- |
| `__cpp_lib_constexpr_exceptions` | `202411L` | (C++26) | `constexpr` for exception types |

#### Example

```cpp
#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:

```text
Allocation failed: std::bad_alloc
```

#### See also

- [`operator new`](https://en.cppreference.com/w/cpp/memory/new/operator_new), [`operator new[]`](https://en.cppreference.com/w/cpp/memory/new/operator_new): allocation functions (function)

---
Attribution: content from https://en.cppreference.com/w/cpp/memory/new/bad_alloc (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.