operator delete (<new>)

La fonction appelée par une expression de suppression pour libérer la mémoire pour un tableau d'objets.

void operator delete[](
   void* _Ptr
) throw( );
void operator delete[](
   void *, 
   void *
) throw( );
void operator delete[](
   void* _Ptr, 
   const std::nothrow_t&
) throw( );

Paramètres

• _Ptr
  Pointeur dont la valeur sera rendue non valide par la suppression.

Notes

La première fonction est appelée par une expression d' delete[] pour afficher la valeur d' _Ptr non valide.La fonction est remplaçable car le programme peut définir une fonction avec cette signature de la fonction qui remplace la version par défaut définie par la bibliothèque C++ standard.Le comportement requis est de recevoir une valeur d' _Ptr qui est null ou qui a été retournée par un rappel à operator new [](size_t).Le comportement par défaut pour une valeur NULL d' _Ptr consiste à ne rien.Toute autre valeur d' _Ptr doit être une valeur retournée précédemment par un appel comme décrit précédemment.Le comportement par défaut pour une telle valeur autre que Null d' _Ptr est de libérer la mémoire allouée par le rappel.Il n'est pas spécifié dans quelles conditions partie ou d'une telle mémoire libérée est allouée par un appel suivant à opérateur new(size_t), ou à quels d' calloc(size_t), d' malloc(size_t), ou d' realloc(void*, size_t).

La deuxième fonction est appelée par une expression d' delete[] de positionnement qui correspond à une expression d' new[] du formulaire new[](std::size_t).Elle ne fait rien.

La troisième fonction est appelée par une expression de suppression de positionnement qui correspond à une expression d' new[] du formulaire new[](std::size_t, const std::nothrow_t&).Le programme peut définir une fonction avec cette signature de la fonction qui remplace la version par défaut définie par la bibliothèque C++ standard.Le comportement requis est de recevoir une valeur d' _Ptr qui est null ou qui a été retournée par un rappel à l'opérateur new[](size_t).Le comportement par défaut consiste à évaluer delete[](_Ptr).

Exemple

Consultez l' operator new [] pour obtenir des exemples d'utilisation d' operator delete[].

Configuration requise

en-tête : <new>

l'espace de noms : DST