Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

delete e delete[] — destruir objetos dinâmicos

Uma expressão delete destrói um único objeto criado com new, enquanto delete[] destrói um array criado com new[]. É obrigatório usar a forma correspondente; confundir as formas provoca comportamento indefinido.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

delete pointer;
delete[] pointer;

delete pointer destrói um único objeto criado com new, enquanto delete[] pointer destrói um array criado com new[]. Ambas as expressões têm o tipo void. No caso habitual, chamam os destrutores e depois libertam o armazenamento; os elementos de um array são destruídos pela ordem inversa.

Não confundas a expressão delete com a função de desalocação operator delete: a expressão também trata da destruição do objeto. Para arrays, a função correspondente é operator delete[]. O mecanismo especial destroying operator delete delega a destruição na função selecionada.

Usar de forma incompatível new/delete[] ou new[]/delete, eliminar um objeto local ou eliminar duas vezes o mesmo objeto provoca comportamento indefinido. Com a desalocação habitual, eliminar um único objeto através de um ponteiro para uma classe base só exige um destrutor virtual nessa classe se os tipos estático e dinâmico do objeto não forem semelhantes. Não elimines arrays através de um ponteiro para uma classe base.

Se uma expressão delete ou delete[] bem formada tiver um ponteiro nulo como operando, C++23 não especifica se a função de desalocação selecionada é chamada. As funções de desalocação fornecidas pela biblioteca padrão não têm qualquer efeito quando são chamadas com um ponteiro nulo. Esta garantia não se aplica a uma função de desalocação específica de uma classe, que pode não lidar com um ponteiro nulo de forma segura.

delete não define a variável ponteiro como nullptr. Uma atribuição explícita depois da eliminação altera apenas essa variável, não os outros ponteiros para o objeto eliminado.

Exemplos

#include <iostream>

struct Item {
    int id;
    ~Item() { std::cout << id << '\n'; }
};

int main() {
    Item* single = new Item{1};
    Item* array = new Item[2]{{2}, {3}};

    delete single;
    single = nullptr;
    delete[] array;
    array = nullptr;
    delete single;
}

Resultado

1
3
2

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata. O último `delete single` tem um ponteiro nulo como operando, mas `Item` não tem uma função de desalocação específica da classe.

Fontes