operator delete[] (<new>)

La funzione chiamata da un'espressione elimina per rilasciare la memoria per una matrice di oggetti.

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

Parametri

• _Ptr
  Puntatore il cui valore deve essere reso non valido dall'eliminazione.

Note

La prima funzione viene chiamata da un'espressione di delete[] per eseguire il rendering del valore di _Ptr non valido. La funzione è sostituibile perché il programma può definire una funzione con la firma della funzione che sostituisce la versione predefinita definita la libreria C++ standard. Il comportamento è obbligatorio di accettare un valore di _Ptr che è null o che è stato restituito da una chiamata precedente a operatori new [](size_t). Il comportamento predefinito per un valore null di _Ptr consiste nel non viene eseguita alcuna operazione. Qualsiasi altro valore di _Ptr deve essere un valore restituito precedentemente da una chiamata come descritto in precedenza. Il comportamento predefinito per tale valore diverso da null di _Ptr è recuperare la memoria allocata dalla chiamata precedente. Non è specificato in quali condizioni parte o tutta tale memoria recuperata viene allocata da una chiamata successiva a operatore new(size_t), o in uno qualsiasi di calloc(size_t), di malloc(size_t), o di realloc(void*, size_t).

La seconda funzione viene chiamata da un'espressione di delete[] di posizione che corrisponde a un'espressione di new[] del form new[](std::size_t). Non esegue alcuna operazione.

La terza funzione viene chiamata da un'espressione delete di posizione che corrisponde a un'espressione di new[] del form new[](std::size_t, const std::nothrow_t&). Il programma può definire una funzione con la firma della funzione che sostituisce la versione predefinita definita la libreria C++ standard. Il comportamento è obbligatorio di accettare un valore di _Ptr che è null o che è stato restituito da una chiamata precedente all'operatore new[](size_t). Il comportamento predefinito prevede di valutare delete[](_Ptr).

Esempio

Vedere operatori new [] per esempi di utilizzo di operator delete[].

Requisiti

Intestazione: <nuovo>

Spazio dei nomi: std