std::bad_array_new_length

From cppreference.com

Defined in header `<new>`

class bad_array_new_length;		(since C++11)

std::bad_array_new_length is the type of the object thrown as exceptions by the new-expressions to report invalid array lengths if

1) array length is negative

2) total size of the new array would exceed implementation-defined maximum value

3) 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

Inherited from std::bad_alloc

Inherited from std::exception

Member functions


(destructor) [virtual]	destructs the exception object (virtual public member function of `std::exception`)

what [virtual]	returns an explanatory string (virtual public member function of `std::exception`)

[edit] Notes

The override for the virtual member function what() may by provided, but is not required.

[edit] Example

Three conditions where std::bad_array_new_length should be thrown:

run this code

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

[edit] See also


operator new operator new[]	allocation functions (function)

bad_alloc	exception thrown when memory allocation fails (class)

Language
Standard library headers
Concepts
Utilities library
Strings library
Containers library
Algorithms library
Iterators library
Numerics library
Input/output library
Localizations library
Regular expressions library (C++11)
Atomic operations library (C++11)
Thread support library (C++11)