Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

Définition explicitement supprimée d’une fonction ou d’un constructeur : `= delete`

`= delete` interdit l’utilisation d’une fonction ou d’un constructeur précis. La déclaration participe toujours à la résolution de surcharge et ne libère aucune mémoire.

Version : ISO C++23; implementation support may vary

Syntaxe

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

Dans IdGen, IdGen() = delete; déclare le constructeur par défaut et constitue aussi sa définition explicitement supprimée. Un constructeur n’a pas de type de retour et = delete; remplace le corps entre accolades : ce n’est pas une affectation. Cette forme doit figurer dans la première déclaration de la fonction. Elle s’applique aussi à une fonction ordinaire déclarée dans un espace de noms, comme void set_id(double) = delete;.

Une surcharge supprimée participe toujours à la résolution de surcharge. Un appel ordinaire qui sélectionne une surcharge supprimée est mal formé et exige un diagnostic : la résolution ne se rabat pas sur la surcharge suivante. En revanche, si la substitution des arguments du modèle rend une exigence dépendante invalide parce qu’elle ferait appel à une fonction supprimée, l’expression requires peut valoir false sans rendre le programme mal formé. Dans l’exemple, IdGen{42} sélectionne le constructeur prenant un int, IdGen{} le constructeur par défaut supprimé et IdGen{3.5} le constructeur supprimé prenant un double, sans convertir l’argument en int.

Il ne s’agit pas des expressions delete p ou delete[] p. Celles-ci opèrent sur un pointeur et servent à détruire les objets créés par la forme correspondante de new ou new[] et à libérer leur mémoire via des fonctions de désallocation comme operator delete ou operator delete[]. Une définition avec = delete; ne met pas fin à la durée de vie d’un objet, ne libère pas de mémoire et ne lève pas d’exception.

La forme = delete; existe depuis C++11 et fait partie de C++23. La forme avec un motif, = delete("reason");, ne fait pas partie de C++23 ; la prise en charge de cette syntaxe ultérieure dépend de l’implémentation.

Exemples

#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';
}

Résultat

42

Sans modification, le programme affiche `42`. Décommente chacune des deux lignes séparément pour constater l’erreur de compilation due à la sélection du constructeur supprimé correspondant. Le texte du diagnostic dépend du compilateur.

Leçons associées

  • C++ · Leçon 5 · Intermédiaire · Version : 2

Sources