Namespaces
Variants

std:: bad_alloc

From cppreference.net
< cpp ‎ | memory ‎ | new
C++
Utilities library
Memory management library
( exposition only* )
Allocators
Uninitialized memory algorithms
Constrained uninitialized memory algorithms
Memory resources
Uninitialized storage (until C++20)
( until C++20* )
( until C++20* )
( until C++20* )

Garbage collector support (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
Low level memory management
ヘッダーで定義 <new>
class bad_alloc : public std:: exception

std::bad_alloc は、 アロケーションファンクション がストレージの確保に失敗したことを報告するためにスローする例外オブジェクトの型です。

cpp/error/exception std-bad alloc-inheritance.svg

継承図

目次

メンバー関数

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

std::bad_alloc:: bad_alloc

(1)
bad_alloc ( ) throw ( ) ;
(C++11まで)
bad_alloc ( ) noexcept ;
(C++11から)
(constexprはC++26から)
(2)
bad_alloc ( const bad_alloc & other ) throw ( ) ;
(C++11まで)
bad_alloc ( const bad_alloc & other ) noexcept ;
(C++11から)
(constexprはC++26から)

実装定義のヌル終端バイト文字列を持つ新しい bad_alloc オブジェクトを構築します。この文字列は what() を通じてアクセス可能です。

1) デフォルトコンストラクタ。
2) コピーコンストラクタ。 * this と other の両方が動的型 std::bad_alloc を持つ場合、 std:: strcmp ( what ( ) , other. what ( ) ) == 0 となります。 (C++11から)

パラメータ

other - コピーする別の例外オブジェクト

std::bad_alloc:: operator=

bad_alloc & operator = ( const bad_alloc & other ) throw ( ) ;
(C++11まで)
bad_alloc & operator = ( const bad_alloc & other ) noexcept ;
(C++11以降)
(C++26以降 constexpr)

other の内容を代入します。 * this と other の両方が動的型 std::bad_alloc を持つ場合、代入後は std:: strcmp ( what ( ) , other. what ( ) ) == 0 となります。 (C++11以降)

パラメータ

other - 代入する別の例外オブジェクト

戻り値

* this

std::bad_alloc:: what

virtual const char * what ( ) const throw ( ) ;
(C++11まで)
virtual const char * what ( ) const noexcept ;
(C++11以降)
(C++26以降 constexpr)

説明文字列を返します。

戻り値

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

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

(C++26以降)

注記

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

std::exception から継承

メンバ関数

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

注記

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

例

このコードを実行 
#include <iostream>
#include <new>
int main()
{
    try
    {
        while (true)
        {
            new int[100000000ul];
        }
    }
    catch (const std::bad_alloc& e)
    {
        std::cout << "Allocation failed: " << e.what() << '\n';
    }
}

出力例: 

Allocation failed: std::bad_alloc

関連項目

確保関数
(関数)