std::bad_alloc

< cpp‎ | memory‎ | new
 
C++
 
工具库
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
(C++14)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)(C++20)(C++20)(C++20)
(C++20)
swap 与类型运算
(C++20)
(C++14)
(C++11)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)

初等字符串转换
(C++17)
(C++17)
(C++17)
 
动态内存管理
智能指针
(C++11)
(C++11)
(C++11)
(C++17 前)
(C++11)
(C++11)
(C++11)
(C++11)
分配器
(C++11)
(C++11)
(C++11)
(C++11)
(C++20)
(C++20)
(C++20)
(C++11)
(C++17)
内存资源
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
未初始化存储
(C++20 前)
(C++20 前)
(C++20 前)
未初始化内存算法
有制约的未初始化内存算法
垃圾收集支持
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
杂项
(C++11)
(C++20)
(C++11)
(C++11)
(C++20)
C 库
低层内存管理
 
低层内存管理
 
定义于头文件 <new>
class bad_alloc;

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

cpp/error/exceptionstd-bad alloc-inheritance.svg

继承图

成员函数

(构造函数)
 构造新的 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 的虚公开成员函数)
[虚]
 返回解释性字符串
(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

参阅

 分配函数
(函数)