Partager via


operator delete (<new>)

Fonction appelée par une expression de suppression pour libérer le stockage pour l'individu 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 de suppression pour afficher la valeur d' _Ptr non valide.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 à opérateur 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 à operator 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 de suppression de positionnement correspondant à une nouvelle expression du formulaire new(std::size_t).Elle ne fait rien.

La troisième fonction est appelée par une expression de suppression de positionnement correspondant à une nouvelle expression du formulaire new(std::size_t, conststd::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 à operator new(size_t).Le comportement par défaut consiste à évaluer delete(_Ptr).

Exemple

Consultez l' opérateur new pour obtenir un exemple qui utilisent operator delete.

Configuration requise

en-tête : <new>

l'espace de noms : DST