std::bad_array_new_length
<new>
std::bad_array_new_length is the type of the object thrown as exceptions by the new-expressions to report invalid array lengths if
- Array length is negative,
- Total size of the new array would exceed implementation-defined maximum value,
- The number of initializer-clauses exceeds the number of elements to initialize.
Only the first array dimension may generate this exception; dimensions other than the first are constant expressions and are checked at compile time.
Inheritance diagram
Contents
[edit] Member functions
bad_array_new_length object (public member function)
bad_array_new_length object (public member function)
(public member function)
std::bad_array_new_length::bad_array_new_length
(constexpr since C++26)
(constexpr since C++26)
Constructs a new bad_array_new_length object with an implementation-defined null-terminated byte string which is accessible through what().
std::bad_array_new_length then std::strcmp (what(), other.what()) == 0.Parameters
std::bad_array_new_length::operator=
(constexpr since C++26)
Assigns the contents with those of other. If *this and other both have dynamic type std::bad_array_new_length then std::strcmp (what(), other.what()) == 0 after assignment.
Parameters
Return value
*this
std::bad_array_new_length::what
(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::bad_alloc
Inherited from std::exception
Member functions
[edit] Notes
| Feature-test macro | Value | Std | Feature |
|---|---|---|---|
__cpp_lib_constexpr_exceptions |
202411L |
(C++26) | constexpr for exception types |
[edit] Example
Three conditions where std::bad_array_new_length should be thrown:
#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"; }
Possible output:
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