CKTIS / C++
new — créer des objets et obtenir du stockage
Une expression new crée un objet et renvoie un pointeur vers celui-ci ; elle obtient généralement aussi du stockage. Distinguez-la de la fonction d’allocation operator new et découvrez new[] pour les tableaux ainsi que l’expression Placement new, qui construit un objet dans un stockage fourni.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
new T(args...)
new T{args...}
new T[n]{}
::new (address) T{args...}
new (std::nothrow) T{args...}Si T n’est pas un type tableau, new T{args...} crée et initialise un objet et renvoie un pointeur de type T*. Une expression new n’est pas la même chose que la fonction operator new : cette dernière fournit du stockage brut, mais n’appelle pas elle-même de constructeur. L’initialiseur compte : new int laisse une valeur indéterminée qu’il ne faut pas lire en C++23 ; new int{} produit zéro.
La forme new[], par exemple new T[n]{}, crée un tableau. Si l’opération réussit et que n > 0, elle renvoie un pointeur vers le premier élément. En C++23, n == 0 est autorisé : le tableau ne contient aucun élément, il ne faut donc pas déréférencer le pointeur renvoyé. Associez delete à un new ordinaire pour un objet unique, et delete[] à un new qui crée un tableau, même si celui-ci est de longueur nulle. Par exemple, après using T = int[3];, new T{} renvoie un pointeur de type int* vers le premier élément. Il faut utiliser delete[] pour supprimer le tableau, même si l’expression new ne contient pas de crochets. Mélanger ces formes entraîne un comportement indéfini. La destruction des objets ne réinitialise pas les pointeurs qui contiennent leurs adresses.
La fonction d’allocation standard avec exceptions lance std::bad_alloc lorsqu’elle ne peut pas obtenir de stockage. Si new (std::nothrow) T{} sélectionne la surcharge standard de la fonction d’allocation qui ne lance pas d’exception, l’expression renvoie nullptr en cas d’échec de l’allocation. Si T est un type classe, l’expression peut sélectionner à la place une surcharge d’allocation propre à la classe qui accepte std::nothrow_t, mais peut tout de même lancer une exception. Même avec la surcharge standard qui ne lance pas d’exception, l’expression peut propager une exception du constructeur. Vérifiez le résultat avant de le déréférencer. Si un constructeur lance une exception, l’expression new appelle une fonction de désallocation appropriée si elle en trouve une.
Une expression Placement new de la forme ::new (address) T{args...}, utilisant la surcharge standard prenant un void* de <new>, construit un objet dans un stockage existant sans en allouer. L’adresse fournie ne doit pas être nullptr, et le stockage doit être suffisamment grand, correctement aligné et disponible pendant toute la durée de vie de l’objet. Pour le tampon de l’exemple, appelez placed->~Item(), et non delete placed ; le tampon a sa propre durée de vie.
Portée de l’entrée : C++23. L’option du compilateur associée dans le dépôt ne garantit pas l’environnement d’exécution de production. L’URL de la norme fournie pointe vers un projet de travail en évolution, et non vers une édition C++23 figée.
Exemples
#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();
}
Résultat
7 6 9
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.