Namespaces
Variants

    std::bad_array_new_length

    ja.cppreference.net より
     
    C++
    コンパイラサポート
    フリースタンディングとホスト環境
    言語
    標準ライブラリ
    標準ライブラリヘッダ
    名前付き要件
    機能テストマクロ (C++20)
    言語サポートライブラリ
    コンセプトライブラリ (C++20)
    診断ライブラリ
    メモリ管理ライブラリ
    メタプログラミングライブラリ (C++11)
    汎用ユーティリティライブラリ
    コンテナライブラリ
    イテレータライブラリ
    レンジライブラリ (C++20)
    アルゴリズムライブラリ
    文字列ライブラリ
    テキスト処理ライブラリ
    数値ライブラリ
    日時ライブラリ
    入出力ライブラリ
    ファイルシステムライブラリ (C++17)
    並行性サポートライブラリ (C++11)
    実行制御ライブラリ (C++26)
    技術仕様書
    シンボルインデックス
    外部ライブラリ
     
    ユーティリティライブラリ
    言語サポート
    型サポート (基本型、RTTI)
    ライブラリ機能テストマクロ (C++20)
    プログラムユーティリティ
    可変引数関数
    (C++11)
    (C++20)
    (C++26)
    (C++20)
    コルーチンサポート (C++20)
    契約サポート (C++26)
    三方比較
    (C++20)(C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)    
    (C++20)(C++20)(C++20)    
    (C++20)(C++20)(C++20)

    汎用ユーティリティ
    関係演算子 (C++20で非推奨)
    整数比較関数
    (C++20)(C++20)(C++20)    
    (C++20)
    swap と 型操作
    (C++20)
    (C++14)
    (C++11)
    (C++23)
    (C++11)
    (C++23)
    (C++11)
    (C++11)
    (C++17)
    共通語彙型
    (C++11)
    (C++17)
    (C++17)
    (C++17)
    (C++11)
    (C++11)
    (C++17)
    (C++17)
    (C++23)



     
    メモリ管理ライブラリ
    アロケータ
    (C++17)
    (C++20)
    メモリリソース
    未初期化ストレージ (C++20まで*)
    ガベージコレクタサポート (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 alloc

    継承図

    メンバー関数

    (constructor)
    		新しい bad_array_new_length オブジェクトを構築する
    (public member function)
    operator=
    		bad_array_new_length オブジェクトを置き換える
    (public member function)
    what
    		説明文字列を返す
    (public member function)

    std::bad_array_new_length:: bad_array_new_length

    bad_array_new_length ( ) noexcept ;
    		(1) (C++11以降)
    (constexpr since C++26)
    bad_array_new_length ( const bad_array_new_length & other ) noexcept ;
    		(2) (C++11以降)
    (constexpr since C++26)

    新しいbad_array_new_lengthオブジェクトを構築します。実装定義のnull終端バイト文字列が含まれ、これは what() を通じてアクセス可能です。

    1) デフォルトコンストラクタ。
    2) コピーコンストラクタ。 * this と other の両方が動的型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以降)
    (constexpr C++26以降)

    other の内容を代入します。 * this と other の両方が動的型 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以降)
    (constexpr C++26以降)

    説明文字列を返します。

    戻り値

    説明情報を含む実装定義のナル終端文字列へのポインタ。この文字列は std::wstring への変換と表示に適しています。ポインタは、少なくとも取得元の例外オブジェクトが破棄されるまで、または例外オブジェクトの非constメンバ関数（コピー代入演算子など）が呼び出されるまで有効であることが保証されます。

    定数評価中、返される文字列は通常のリテラルエンコーディングでエンコードされます。

    		(C++26以降)

    注記

    実装は what() をオーバーライドすることが許可されていますが、必須ではありません。

    std:: bad_alloc から継承

    std::exception から継承 std:: exception

    メンバ関数

    [virtual]
    		例外オブジェクトを破棄
    (std::exception の仮想公開メンバ関数)
    [virtual]
    		説明文字列を返す
    (std::exception の仮想公開メンバ関数)

    注記

    機能テスト マクロ 値 標準 機能
    __cpp_lib_constexpr_exceptions 202411L (C++26) constexpr 例外型のためのconstexpr

    例

    std::bad_array_new_lengthがスローされるべき3つの条件：

    このコードを実行 
    #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

    関連項目

    		メモリ確保関数
    (関数)
    		メモリ確保が失敗したときにスローされる例外
    (クラス)