Namensräume
Varianten
Aktionen

std::bad_array_new_length

Von cppreference.com
< cpp‎ | memory‎ | new
 
C++
 
Dienstprogramm-Bibliotheken
Sprachunterstützung
Typunterstützung (Basistypen, RTTI)
Bibliotheks-Feature-Test-Makros (C++20)
Programm-Dienstprogramme
Variadische Funktionen
(C++11)
(C++20)
(C++26)
(C++20)
Coroutine-Unterstützung (C++20)
Vertragsunterstützung (C++26)
Drei-Wege-Vergleich
(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)

Allgemeine Hilfsmittel
Relationale Operatoren (in C++20 veraltet)
 
Speicherverwaltungsbibliothek
(nur Exposition*)
Algorithmen für uninitialisierten Speicher
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++17)
(C++17)
(C++17)
(C++20)
Beschränkte uninitialisierte
Speicher-Algorithmen
(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-Bibliothek

Allocatoren
(C++11)
(C++23)
(C++11)
(C++11)
(C++20)
(C++20)
(C++20) 
(C++11)
(C++17)
Speicherressourcen
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
Unterstützung für Garbage Collection
(C++11)(bis C++23)
(C++11)(bis C++23)
(C++11)(bis C++23)
(C++11)(bis C++23)
(C++11)(bis C++23)
(C++11)(bis C++23)
Uninitialisierter Speicher
(bis C++20*)
(bis C++20*)
(bis C++20*)
Explizites Lebenszeitmanagement
(C++23)(C++23)
 
Low-Level-Speicherverwaltung
 
Definiert im Header <new>
class bad_array_new_length;
 (seit C++11)

std::bad_array_new_length ist der Typ des Objekts, das als Ausnahme von den new-Ausdrücken geworfen wird, um ungültige Array-Längen zu melden, wenn

  1. Die Array-Länge negativ ist,
  2. Die Gesamtgröße des neuen Arrays den implementierungsdefinierten Maximalwert überschreiten würde,
  3. Die Anzahl der Initialisierer-Klauseln die Anzahl der zu initialisierenden Elemente überschreitet.

Nur die erste Array-Dimension kann diese Ausnahme auslösen; andere Dimensionen sind konstante Ausdrücke und werden zur Kompilierungszeit überprüft.

cpp/error/exceptioncpp/memory/new/bad allocstd-bad array new length-inheritance.svg

Vererbungdiagramm

Inhalt

[bearbeiten] Member-Funktionen

(Konstruktor)
 konstruiert ein neues bad_array_new_length-Objekt
(öffentliche Memberfunktion)
operator=
 ersetzt das bad_array_new_length-Objekt
(öffentliche Memberfunktion)
what
 gibt den erklärenden String zurück
(öffentliche Memberfunktion)

std::bad_array_new_length::bad_array_new_length

bad_array_new_length() noexcept;
 (1) (seit C++11)
bad_array_new_length( const bad_array_new_length& other ) noexcept;
 (2) (seit C++11)

Konstruiert ein neues bad_array_new_length-Objekt mit einem implementierungsdefinierten nullterminierten Byte-String, der über what() zugänglich ist.

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

Parameter

Sonstiges - ein anderes Ausnahmeobjekt zum Kopieren

std::bad_array_new_length::operator=

bad_array_new_length& operator=( const bad_array_new_length& other ) noexcept;
 (seit C++11)

Weist den Inhalt denen von other zu. Wenn *this und other beide den dynamischen Typ std::bad_array_new_length haben, dann gilt std::strcmp(what(), other.what()) == 0 nach der Zuweisung.

Parameter

Sonstiges - ein anderes Ausnahmeobjekt zum Zuweisen

Rückgabewert

*this

std::bad_array_new_length::what

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

Gibt den erklärenden String zurück.

Rückgabewert

Zeiger auf einen implementierungsdefinierten, nullterminierten String mit erläuternden Informationen. Der String kann für die Konvertierung und Anzeige als std::wstring verwendet werden. Der Zeiger ist garantiert gültig, mindestens bis das Ausnahmeobjekt, von dem er stammt, zerstört wird, oder bis eine nicht-const Memberfunktion (z. B. der Kopierzuweisungsoperator) für das Ausnahmeobjekt aufgerufen wird.

Der zurückgegebene String ist während der konstanten Auswertung mit der gewöhnlichen Literal-Codierung kodiert.

 (seit C++26)

Anmerkungen

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

Erbt von std::bad_alloc

Abgeleitet von std::exception

Memberfunktionen

[virtuell]
 zerstört das Ausnahmeobjekt
(virtuelle öffentliche Memberfunktion von std::exception) [bearbeiten]
[virtuell]
 gibt einen erklärenden String zurück
(virtuelle öffentliche Memberfunktion von std::exception) [bearbeiten]

[bearbeiten] Hinweise

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

[bearbeiten] Beispiel

Drei Bedingungen, unter denen std::bad_array_new_length ausgelöst werden sollte

Führen Sie diesen Code aus
#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";
}

Mögliche Ausgabe

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

[bearbeiten] Siehe auch

 Allokationsfunktionen
(Funktion) [bearbeiten]
 Ausnahme, die ausgelöst wird, wenn die Speicherallokation fehlschlägt
(Klasse) [bearbeiten]
Abgerufen von "https://cppreference.de/mwiki/index.php?title=cpp/memory/new/bad_array_new_length&oldid=177865"