View source for cpp/memory/new/bad array new length

{{cpp/title|bad_array_new_length}}
{{cpp/memory/new/navbar}}
{{dcl begin}}
{{dcl header|new}}
{{dcl|since=c++11|1=
class bad_array_new_length;
}}
{{dcl end}}

{{tt|std::bad_array_new_length}} is the type of the object thrown as exceptions by the [[cpp/language/new|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/std-bad_array_new_length}}

===Member functions===
{{cpp/error/exception/member of derived|bad_array_new_length|std=c++11}}

{{cpp/memory/new/bad_alloc/inherit}}

{{cpp/error/exception/inherit}}

===Example===
{{example
|Three conditions where {{tt|std::bad_array_new_length}} should be thrown:
|code=
#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";
}
|p=true
|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
}}

===See also===
{{dsc begin}}
{{dsc inc|cpp/memory/new/dsc operator_new}}
{{dsc inc|cpp/memory/new/dsc bad_alloc}}
{{dsc end}}

{{langlinks|de|es|fr|it|ja|pt|ru|zh}}