Namespaces
Variants

std::bad_alloc

Von de.cppreference.net
< cpp | memory | new
 
 
Dienstprogrammbibliothek
Sprachunterstützung
Typunterstützung (Basistypen, RTTI)
Bibliotheks-Feature-Test-Makros (C++20)
Programm-Dienstprogramme
Variadische Funktionen
Koroutinenunterstützung (C++20)
Vertragsunterstützung (C++26)
Drei-Wege-Vergleich
(C++20)
(C++20)(C++20)(C++20)    
(C++20)(C++20)(C++20)

Allgemeine Dienstprogramme
Relationale Operatoren (veraltet in C++20)
Integer-Vergleichsfunktionen
(C++20)(C++20)(C++20)    
(C++20)
Tausch und Typoperationen
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
Gängige Vokabular-Typen
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)



 
Speicherverwaltungsbibliothek
Allokatoren
Speicherressourcen
Nicht initialisierter Speicher (bis C++20*)
Unterstützung für Garbage Collector (bis C++23)
 
 
Definiert im Header <new>
class bad_alloc;

std::bad_alloc ist der Typ des Objekts, das als Ausnahme von den Allokationsfunktionen geworfen wird, um einen Fehler bei der Speicherallokation zu melden.

cpp/error/exception

Vererbungsdiagramm

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)

Weist den Inhalt mit dem von other zu. Wenn *this und other beide den dynamischen Typ std::bad_alloc haben, dann 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

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