delete expression

Détruit l'objet (ou les objets) précédemment alloué(s) par l' expression new et libère la zone mémoire obtenue.

Syntaxe

Explication

Étant donné le pointeur évalué à partir de expression (après conversions possibles) comme ptr .

Le résultat de l'expression delete a toujours le type void .

Si l'objet en cours de suppression a un type de classe incomplet au moment de la suppression, et que la classe complète a un destructeur non trivial ou une fonction de désallocation, le comportement est indéfini (jusqu'à C++26) le programme est mal formé (depuis C++26) .

Si ptr n'est pas un pointeur nul et que la fonction de désallocation n'est pas un delete destructeur (depuis C++20) , l'expression delete invoque le destructeur (s'il existe) pour l'objet qui est détruit, ou pour chaque élément du tableau en cours de destruction (en procédant du dernier élément au premier élément du tableau). Le destructeur doit être accessible depuis l'endroit où l'expression delete apparaît.

Après cela, qu'une exception ait été levée ou non par un destructeur, l'expression delete invoque la fonction de désallocation : soit operator delete (première version) soit operator delete [ ] (deuxième version) , sauf si l'expression new correspondante était combinée avec une autre expression new (depuis C++14) .

Le nom de la fonction de désallocation est recherché dans la portée du type dynamique de l'objet pointé par ptr , ce qui signifie que les fonctions de désallocation spécifiques à la classe, si présentes, sont trouvées avant les fonctions globales. Si :: est présent dans l'expression delete, seul l'espace de noms global est examiné par cette recherche. Dans tous les cas, toute déclaration autre que celle des fonctions de désallocation usuelles est écartée.

Si une fonction de désallocation est trouvée, la fonction à appeler est sélectionnée comme suit (voir fonction de désallocation pour une description plus détaillée de ces fonctions et de leurs effets) :

• Si les fonctions de désallocation trouvées sont spécifiques à la classe, la fonction de désallocation spécifique à la classe non sensible à la taille (sans paramètre de type std::size_t ) est préférée à la fonction de désallocation spécifique à la classe sensible à la taille (avec un paramètre de type std::size_t ).

La fonction de désallocation sélectionnée doit être accessible depuis l'endroit où l'expression delete apparaît, sauf si la fonction de désallocation est sélectionnée au point de définition du type dynamique ’s destructeur virtuel .

Le pointeur vers le bloc de stockage à libérer est passé à la fonction de désallocation qui a été sélectionnée par le processus ci-dessus comme premier argument. La taille du bloc est passée comme argument optionnel std::size_t . L'exigence d'alignement est passée comme argument optionnel std::align_val_t . (depuis C++17)

Si ptr est une valeur de pointeur nul, aucun destructeur n'est appelé, et la fonction de désallocation peut ou non être appelée (c'est non spécifié), mais les fonctions de désallocation par défaut sont garanties de ne rien faire lorsqu'elles reçoivent un pointeur nul.

Si ptr est un pointeur vers un sous-objet de classe de base de l'objet qui a été alloué avec new , le destructeur de la classe de base doit être virtual , sinon le comportement est indéfini.

Notes

Un pointeur vers void ne peut pas être supprimé car il ne s'agit pas d'un pointeur vers un type objet.

// delete []{ return new int; }(); // erreur d'analyse
delete ([]{ return new int; })();  // OK

Mots-clés

delete

Rapports de défauts

Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

Voir aussi

• new