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

CKTIS / C++

Definição 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 sem o retirar do conjunto de sobrecargas. Não destrói objetos nem liberta memória.

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

Sintaxe

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

void f(double) = delete;

IdGen() = delete; define explicitamente o construtor por omissão como eliminado. Escreve = delete na primeira declaração da função, em vez de um corpo entre chavetas. A mesma sintaxe também se aplica a funções comuns e faz parte de C++23. A declaração em si não executa nenhuma operação.

Uma função eliminada continua a participar na resolução de sobrecargas. Se for selecionada, o programa está malformado e o compilador tem de emitir um diagnóstico; não recorre a outra sobrecarga. IdGen{} seleciona o construtor por omissão eliminado. IdGen{42.5} seleciona a sobrecarga eliminada para double, enquanto IdGen{42} usa o construtor para int.

Não confundas = delete com as expressões delete p e delete[] p. Numa utilização válida típica, destroem em tempo de execução, respetivamente, um objeto criado com new ou os elementos de um array criado com new[] e chamam a função de libertação de memória correspondente (operator delete ou operator delete[]). Isto diz respeito ao tempo de vida dos objetos: remete para a entrada sobre o modelo de objetos sem duplicar aí a explicação de = delete.

Exemplos

#include <iostream>

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

    int next() { return next_id++; }

private:
    int next_id;
};

int main() {
    // IdGen no_seed{};
    // IdGen fractional{42.5};

    IdGen ids{42};
    std::cout << ids.next() << '\n';
    std::cout << ids.next() << '\n';
}

Resultado

42
43

Sem alterações, o programa escreve `42` e `43` em linhas separadas. Retira o comentário de cada declaração separadamente e volta a compilar para veres o erro de utilização de um construtor eliminado.

Lições relacionadas

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

Fontes