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

CKTIS / C++

Definição explicitamente eliminada de uma função ou de um construtor: `= delete`

`= delete` impede a utilização de uma função ou de um construtor específico. A declaração continua a participar na resolução de sobrecarga e não liberta memória.

Versão: ISO C++23; implementation support may vary

Sintaxe

IdGen() = delete;                  // inside the class definition of IdGen
void set_id(double) = delete;      // at namespace scope

Dentro de IdGen, IdGen() = delete; declara o construtor predefinido e é também a sua definição explicitamente eliminada. Um construtor não tem tipo de retorno e = delete; substitui o corpo entre chavetas: não é uma atribuição. Esta forma tem de constar da primeira declaração da função. Também pode ser usada numa função comum no âmbito de um espaço de nomes, como void set_id(double) = delete;.

Uma sobrecarga eliminada continua a participar na resolução de sobrecarga. Uma chamada normal que seleciona uma sobrecarga eliminada está mal formada e exige um diagnóstico; a resolução não passa à sobrecarga seguinte na ordem de preferência. Se, pelo contrário, a substituição dos argumentos do modelo tornar inválido um requisito dependente por este envolver a utilização de uma função eliminada, a expressão requires pode resultar em false sem que o programa fique mal formado. No exemplo, IdGen{42} seleciona o construtor que recebe um int, IdGen{} seleciona o construtor predefinido eliminado e IdGen{3.5} seleciona o construtor eliminado que recebe um double, sem converter o argumento para int.

Isto não é uma expressão delete p nem delete[] p. Estas expressões operam sobre um ponteiro e servem para destruir objetos criados com o new ou new[] correspondente e libertar a sua memória através de funções de desalocação como operator delete ou operator delete[]. Uma definição com = delete; não termina o tempo de vida de um objeto, não liberta memória nem lança uma exceção.

A forma = delete; existe desde C++11 e faz parte de C++23. A variante com justificação, = delete("reason");, não faz parte de C++23; o suporte para essa sintaxe posterior depende da implementação.

Exemplos

#include <iostream>

struct IdGen {
    IdGen() = delete;
    explicit IdGen(int id) : id{id} {}
    explicit IdGen(double) = delete;

    int id;
};

int main() {
    IdGen valid{42};
    // IdGen missing{};
    // IdGen fractional{3.5};
    std::cout << valid.id << '\n';
}

Resultado

42

Sem alterações, o programa escreve `42`. Descomenta cada uma das duas linhas separadamente para veres o erro de compilação resultante da seleção do construtor eliminado correspondente. O texto do diagnóstico depende do compilador.

Lições relacionadas

  • C++ · Lição 5 · Intermédio · Versão: 2

Fontes