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
Definiert im Header <new>
class bad_alloc : public std:: exception

std::bad_alloc ist der Typ des Objekts, das als Exception von den Allokierungsfunktionen geworfen wird, um Fehler bei der Speicherreservierung zu melden.

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

Vererbungsdiagramm

Inhaltsverzeichnis

Memberfunktionen

(Konstruktor)
konstruiert ein neues bad_alloc Objekt
(öffentliche Elementfunktion)
operator=
ersetzt das bad_alloc Objekt
(öffentliche Elementfunktion)
what
gibt die erklärende Zeichenkette zurück
(öffentliche Elementfunktion)

std::bad_alloc:: bad_alloc

(1)
bad_alloc ( ) throw ( ) ;
(bis C++11)
bad_alloc ( ) noexcept ;
(seit C++11)
(constexpr seit C++26)
(2)
bad_alloc ( const bad_alloc & other ) throw ( ) ;
(bis C++11)
bad_alloc ( const bad_alloc & other ) noexcept ;
(seit C++11)
(constexpr seit C++26)

Konstruiert ein neues bad_alloc -Objekt mit einer implementierungsdefinierten nullterminierten Byte-Zeichenkette, die über what() zugänglich ist.

1) Standardkonstruktor.
2) Kopierkonstruktor. Wenn * this und other beide den dynamischen Typ std::bad_alloc haben, dann gilt std:: strcmp ( what ( ) , other. what ( ) ) == 0 . (seit C++11)

Parameter

other - ein weiteres Ausnahmeobjekt zum Kopieren

std::bad_alloc:: operator=

bad_alloc & operator = ( const bad_alloc & other ) throw ( ) ;
(bis C++11)
bad_alloc & operator = ( const bad_alloc & other ) noexcept ;
(seit C++11)
(constexpr seit C++26)

Weist die Inhalte mit denen von other zu. Wenn * this und other beide den dynamischen Typ std::bad_alloc haben, dann ist std:: strcmp ( what ( ) , other. what ( ) ) == 0 nach der Zuweisung. (seit C++11)

Parameter

other - ein weiteres Ausnahmeobjekt zum Zuweisen

Rückgabewert

* this

std::bad_alloc:: what

virtual const char * what ( ) const throw ( ) ;
(bis C++11)
virtual const char * what ( ) const noexcept ;
(seit C++11)
(constexpr seit C++26)

Gibt die erklärende Zeichenkette zurück.

Rückgabewert

Zeiger auf eine implementierungsdefinierte nullterminierte Zeichenkette mit erklärenden Informationen. Die Zeichenkette ist geeignet für Konvertierung und Anzeige als std::wstring . Der Zeiger ist garantiert mindestens so lange gültig, bis das Ausnahmeobjekt, von dem er erhalten wurde, zerstört wird, oder bis eine nicht-konstante Memberfunktion (z.B. Kopierzuweisungsoperator) auf dem Ausnahmeobjekt aufgerufen wird.

Die zurückgegebene Zeichenkette ist während der konstanten Auswertung mit der gewöhnlichen Literalkodierung kodiert.

(seit C++26)

Anmerkungen

Implementierungen dürfen, sind aber nicht verpflichtet, what() zu überschreiben.

Geerbt von std:: exception

Elementfunktionen

[virtual]
zerstört das Exception-Objekt
(virtuelle öffentliche Elementfunktion von std::exception )
[virtual]
gibt einen erklärenden String zurück
(virtuelle öffentliche Elementfunktion von std::exception )

Hinweise

Feature-Test Makro Wert Std Feature
__cpp_lib_constexpr_exceptions 202411L (C++26) constexpr für Ausnahmetypen

Beispiel

Diesen Code ausführen 
#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';
    }
}

Mögliche Ausgabe: 

Allocation failed: std::bad_alloc

Siehe auch

Allokierungsfunktionen
(Funktion)