命名空间
变体
操作

std::bad_array_new_length

来自 cppreference.com
< cpp‎ | memory‎ | new
 
 
实用程序库
语言支持
类型支持 (基本类型,RTTI)
库功能测试宏 (C++20)
动态内存管理
程序实用程序
协程支持 (C++20)
可变参数函数
调试支持
(C++26)
三向比较
(C++20)
(C++20)(C++20)(C++20)
(C++20)(C++20)(C++20)
通用实用程序
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中已弃用)
整数比较函数
(C++20)(C++20)(C++20)   
(C++20)
交换类型操作
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
通用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
基本字符串转换
(C++17)
(C++17)

 
动态内存管理
未初始化内存算法
受约束的未初始化内存算法
分配器
垃圾回收支持
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)



 
 
在头文件 <new> 中定义
class bad_array_new_length;
(自 C++11 起)

std::bad_array_new_length 是由 new 表达式 抛出以报告无效数组长度的异常对象的类型,如果

  1. 数组长度为负数,
  2. 新数组的总大小将超过实现定义的最大值,
  3. 初始化子句的数量超过要初始化的元素数量。

只有第一个数组维度可能会产生此异常;除了第一个维度之外的维度是常量表达式,并在编译时检查。

cpp/error/exceptioncpp/memory/new/bad allocstd-bad array new length-inheritance.svg

继承关系图

内容

[编辑] 成员函数

(构造函数)
构造一个新的 bad_array_new_length 对象
(公有成员函数)
operator=
替换 bad_array_new_length 对象
(公有成员函数)
what
返回解释性字符串
(公有成员函数)

std::bad_array_new_length::bad_array_new_length

bad_array_new_length() noexcept;
(1) (自 C++11 起)
bad_array_new_length( const bad_array_new_length& other ) noexcept;
(2) (自 C++11 起)

使用可通过 what() 访问的实现定义的以 null 结尾的字节字符串构造一个新的 bad_array_new_length 对象。

1) 默认构造函数。
2) 复制构造函数。如果 *thisother 都是动态类型 std::bad_array_new_length 那么 std::strcmp(what(), other.what()) == 0.

参数

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

std::bad_array_new_length::operator=

bad_array_new_length& operator=( const bad_array_new_length& other ) noexcept;
(自 C++11 起)

将内容赋值为 other 的内容。如果 *thisother 都是动态类型 std::bad_array_new_length,那么在赋值后 std::strcmp(what(), other.what()) == 0

参数

other - 另一个要赋值的异常对象

返回值

*this

std::bad_array_new_length::what

virtual const char* what() const noexcept;
(自 C++11 起)

返回解释性字符串。

参数

(无)

返回值

指向包含解释信息的以 null 结尾的字符串的指针。该字符串适合转换为 std::wstring 并显示。该指针保证在至少在获取该指针的异常对象被销毁之前或在该异常对象的非 const 成员函数(例如复制赋值运算符)被调用之前有效。

备注

实现可以但不要求重写 what()

继承自 std::bad_alloc

继承自 std::exception

成员函数

[虚函数]
销毁异常对象
(std::exception 的虚公有成员函数) [编辑]
[虚函数]
返回解释性字符串
(std::exception 的虚公有成员函数) [编辑]

[编辑] 示例

应该抛出 std::bad_array_new_length 的三种情况

#include <climits>
#include <iostream>
#include <new>
 
int main()
{
    try
    {
        int negative = -1;
        new int[negative];
    }
    catch (const std::bad_array_new_length& e)
    {
        std::cout << "1) " << e.what() << ": negative size\n";
    }
 
    try
    {
        int small = 1;
        new int[small]{1,2,3};
    }
    catch (const std::bad_array_new_length& e)
    {
        std::cout << "2) " << e.what() << ": too many initializers\n";
    }
 
    try
    {
        long large = LONG_MAX;
        new int[large][1000];
    } 
    catch (const std::bad_array_new_length& e)
    {
        std::cout << "3) " << e.what() << ": too large\n";
    }
 
    std::cout << "End\n";
}

可能的输出

1) std::bad_array_new_length: negative size
2) std::bad_array_new_length: too many initializers
3) std::bad_array_new_length: too large
End

[编辑] 另请参阅

分配函数
(函数) [编辑]
内存分配失败时抛出的异常
(类) [编辑]