std::bad_array_new_length
|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Functions | ||||
(C++11) | ||||
| Classes | ||||
bad_array_new_length (C++11) | ||||
(C++17) | ||||
| Types | ||||
| Objects | ||||
(C++20) | ||||
| Object access | ||||
(C++17) |
Defined in header <new> | ||
class bad_array_new_length:std::bad_alloc | (since C++11) | |
std::bad_array_new_length is the type of the object thrown as exceptions by thenew-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
(constructor) | constructs a newbad_array_new_length object(public member function) |
operator= | replaces thebad_array_new_length object(public member function) |
what | returns the explanatory string (public member function) |
std::bad_array_new_length::bad_array_new_length
bad_array_new_length()noexcept; | (1) | (since C++11) (constexpr since C++26) |
bad_array_new_length(const bad_array_new_length& other)noexcept; | (2) | (since C++11) (constexpr since C++26) |
Constructs a newbad_array_new_length object with an implementation-defined null-terminated byte string which is accessible throughwhat().
std::bad_array_new_length thenstd::strcmp(what(), other.what())==0.Parameters
| other | - | another exception object to copy |
std::bad_array_new_length::operator=
bad_array_new_length& operator=(const bad_array_new_length& other)noexcept; | (since C++11) (constexpr since C++26) | |
Assigns the contents with those ofother. If*this andother both have dynamic typestd::bad_array_new_length thenstd::strcmp(what(), other.what())==0 after assignment.
Parameters
| other | - | another exception object to assign with |
Return value
*this
std::bad_array_new_length::what
virtualconstchar* what()constnoexcept; | (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 astd::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 overridewhat().
Inherited fromstd::bad_alloc
Inherited fromstd::exception
Member functions
[virtual] | destroys the exception object (virtual public member function of std::exception)[edit] |
[virtual] | returns an explanatory string (virtual public member function of std::exception)[edit] |
[edit]Notes
| Feature-test macro | Value | Std | Feature |
|---|---|---|---|
__cpp_lib_constexpr_exceptions | 202411L | (C++26) | constexpr for exception types |
[edit]Example
Three conditions wherestd::bad_array_new_length should be thrown:
#include <climits>#include <iostream>#include <new> int main(){try{int negative=-1; newint[negative];}catch(const std::bad_array_new_length& e){std::cout<<"1) "<< e.what()<<": negative size\n";} try{int small=1; newint[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; newint[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 size2) std::bad_array_new_length: too many initializers3) std::bad_array_new_length: too largeEnd
[edit]See also
| allocation functions (function)[edit] | |
| exception thrown when memory allocation fails (class)[edit] |
