CKTIS / C++
new — Objekte erstellen und Speicher belegen
Ein new-Ausdruck erstellt ein Objekt und gibt einen Zeiger darauf zurück; normalerweise beschafft er auch Speicher. Unterscheide ihn von der Allokationsfunktion operator new und lerne Array-new[] sowie den Placement-new-Ausdruck kennen, der ein Objekt in bereitgestelltem Speicher konstruiert.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
new T(args...)
new T{args...}
new T[n]{}
::new (address) T{args...}
new (std::nothrow) T{args...}Wenn T kein Array-Typ ist, erstellt und initialisiert new T{args...} ein Objekt und gibt einen Zeiger vom Typ T* zurück. Ein new-Ausdruck ist nicht dasselbe wie die Funktion operator new: Letztere stellt rohen Speicher bereit, ruft aber selbst keinen Konstruktor auf. Der Initialisierer ist wichtig: new int lässt einen unbestimmten Wert zurück, der in C++23 nicht gelesen werden darf; new int{} ergibt null.
Die Array-Form new[], etwa new T[n]{}, erstellt ein Array. Bei erfolgreicher Ausführung gibt sie für n > 0 einen Zeiger auf das erste Element zurück. In C++23 ist n == 0 zulässig: Das Array hat keine Elemente, daher darf der zurückgegebene Zeiger nicht dereferenziert werden. Verwende delete für gewöhnliches new eines einzelnen Objekts und delete[] für new, das ein Array erstellt, auch bei einem Array der Länge null. Nach using T = int[3]; gibt new T{} beispielsweise einen int* auf das erste Element zurück. Zum Löschen des Arrays ist delete[] erforderlich, obwohl der new-Ausdruck keine eckigen Klammern enthält. Eine Vermischung dieser Formen führt zu undefiniertem Verhalten. Das Löschen von Objekten setzt Zeiger, die ihre Adressen enthalten, nicht zurück.
Die standardmäßige werfende Allokationsfunktion wirft std::bad_alloc, wenn sie keinen Speicher beschaffen kann. Wird bei new (std::nothrow) T{} die standardmäßige nicht werfende Überladung der Allokationsfunktion ausgewählt, gibt der Ausdruck bei einem Allokationsfehler nullptr zurück. Ist T ein Klassentyp, kann der Ausdruck stattdessen eine klassenspezifische Überladung der Allokationsfunktion auswählen, die std::nothrow_t annimmt, aber trotzdem eine Ausnahme werfen kann. Auch mit der standardmäßigen nicht werfenden Überladung kann der Ausdruck eine Ausnahme des Konstruktors weitergeben. Prüfe das Ergebnis vor dem Dereferenzieren. Wirft ein Konstruktor eine Ausnahme, ruft der new-Ausdruck eine passende Freigabefunktion auf, sofern eine gefunden wird.
Ein Placement-new-Ausdruck der Form ::new (address) T{args...} konstruiert mit der standardmäßigen void*-Überladung aus <new> ein Objekt in bereits vorhandenem Speicher, ohne Speicher zu beschaffen. Die übergebene Adresse darf nicht nullptr sein. Der Speicher muss groß genug, korrekt ausgerichtet und während der gesamten Lebensdauer des Objekts verfügbar sein. Rufe für den Puffer im Beispiel placed->~Item() auf, nicht delete placed; der Puffer hat eine eigene Lebensdauer.
Geltungsbereich des Eintrags: C++23. Das zugehörige Compiler-Flag im Repository bestätigt nicht die Produktionslaufzeit. Die angegebene Standard-URL verweist auf einen fortlaufend weiterentwickelten Arbeitsentwurf, nicht auf eine eingefrorene C++23-Ausgabe.
Beispiele
#include <cstddef>
#include <iostream>
#include <new>
struct Item {
int value;
};
int main() {
int* single = new int{7};
std::cout << *single << '\n';
delete single;
int* array = new int[3]{1, 2, 3};
std::cout << array[0] + array[1] + array[2] << '\n';
delete[] array;
alignas(Item) std::byte storage[sizeof(Item)];
Item* placed = ::new (static_cast<void*>(storage)) Item{9};
std::cout << placed->value << '\n';
placed->~Item();
}
Ergebnis
7 6 9
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.