# std::bad_alloc

< cpp‎ | memory‎ | new

定义于头文件 `<new>` |  |
class bad_alloc; |  |

`std::bad_alloc` 是分配函数作为异常抛出的对象类型，以报告存储分配失败。

继承图

### 成员函数

(构造函数) | 构造新的 `bad_alloc` 对象 (公开成员函数)
operator= | 替换 `bad_alloc` 对象 (公开成员函数)
what | 返回解释字符串 (公开成员函数)

## std::bad_alloc::bad_alloc

| (1) |
bad_alloc() throw(); |  | (C++11 前)
bad_alloc() noexcept; |  | (C++11 起)
| (2) |
bad_alloc( const bad_alloc& other ) throw(); |  | (C++11 前)
bad_alloc( const bad_alloc& other ) noexcept; |  | (C++11 起)

构造新的拥有实现定义的空终止字节字符串的 `bad_alloc` 对象，字符串能通过 `what()` 访问。

1) 默认构造函数。
2) 复制构造函数。若 `*this` 与 `other` 均拥有动态类型 `std::bad_alloc` 则 std::strcmp(what(), other.what()) == 0 。 (C++11 起)

### 参数

other | - | 要复制的另一异常对象

## std::bad_alloc::operator=

bad_alloc& operator=( const bad_alloc& other ) throw(); |  | (C++11 前)
bad_alloc& operator=( const bad_alloc& other ) noexcept; |  | (C++11 起)

以 `other` 的内容赋值。若 `*this` 与 `other` 均拥有动态类型 `std::bad_alloc` 则赋值后 std::strcmp(what(), other.what()) == 0 。 (C++11 起)

### 参数

other | - | 用以赋值的另一异常对象

### 返回值

*this

## std::bad_alloc::what

virtual const char* what() const throw(); |  | (C++11 前)
virtual const char* what() const noexcept; |  | (C++11 起)

返回解释字符串。

### 参数

（无）

### 返回值

指向有解释信息的空终止字符串的指针。该字符串适合转换并显示为 std::wstring 。保证该指针至少到获得它来源的异常对象被销毁，或在该异常对象上调用非 const 成员函数（例如复制赋值运算符）为止合法。

### 注解

允许但不要求实现覆写 `what()` 。

## 继承自 std::exception

### 成员函数

(析构函数) [虚] | 析构该异常对象 (`std::exception` 的虚公开成员函数)
what [虚] | 返回解释性字符串 (`std::exception` 的虚公开成员函数)

### 示例

    #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';
        }
    }

可能的输出：

    Allocation failed: std::bad_alloc

### 参阅

operator new operator new[] | 分配函数 (函数)