Pourquoi est-ce que je reçois des erreurs de type "symbole externe non résolu" lorsque j'utilise des modèles ?

Question

Lorsque j'écris du code C++ pour une classe en utilisant des modèles et que je répartis le code entre un fichier source (CPP) et un fichier d'en-tête (H), j'obtiens un grand nombre d'erreurs "unresolved external symbol" au moment de lier l'exécutable final, bien que le fichier objet soit correctement construit et inclus dans la liaison. Que se passe-t-il et comment puis-je y remédier ?

Answer 1

Les classes et les fonctions modélisées ne sont pas instanciées tant qu'elles ne sont pas utilisées, généralement dans un fichier .cpp distinct (par exemple, la source du programme). Lorsque le modèle est utilisé, le compilateur a besoin du code complet de cette fonction pour pouvoir construire la fonction correcte avec le type approprié. Cependant, dans ce cas, le code de cette fonction est détaillé dans le fichier source du modèle et n'est donc pas disponible.

Le résultat de tout cela est que le compilateur suppose qu'il est défini ailleurs et insère seulement l'appel à la fonction modèle. Lorsqu'il s'agit de compiler le fichier source du modèle, le type de modèle spécifique qui est utilisé dans la source du programme n'est pas utilisé, de sorte qu'il ne génère toujours pas le code requis pour la fonction. Il en résulte un symbole externe non résolu.

Les solutions disponibles pour cela sont les suivantes :

1. inclure la définition complète de la la fonction membre dans le fichier d'en-tête du modèle et ne pas avoir un fichier source pour le modèle,
2. définir toutes les fonctions membres dans le fichier source du modèle comme "en ligne" (Mise à jour : [cela ne fonctionne pas sur Visual Studio 2017+]), ou
3. définir les fonctions membres dans la source du modèle avec le mot-clé "export". Malheureusement, ceci n'est pas supporté par beaucoup de compilateurs. (Mise à jour : Ceci a été supprimé de la norme à partir de C++11. .)

Les points 1 et 2 résolvent le problème en donnant au compilateur l'accès au code complet de la fonction modèle lorsqu'il tente de construire la fonction typée dans la source du programme.

Answer 2

Une autre option consiste à placer le code dans le fichier cpp et à ajouter dans ce même fichier cpp des instanciations explicites du modèle avec les types que vous pensez utiliser. C'est utile si vous savez que vous ne l'utiliserez que pour quelques types que vous connaissez à l'avance.

Answer 3

Pour chaque fichier qui inclut le fichier .h, vous devez insérer les deux lignes :

#include "MyfileWithTemplatesDeclaration.h"
#include "MyfileWithTemplatesDefinition.cpp"

---

échantillon

#include "list.h"
    #include "list.cpp" //<---for to fix bug link err 2019

    int main(int argc, _TCHAR* argv[])
    {
        list<int> my_list;
        my_list.add_end(3);
    .
    .
    } 

aussi, n'oubliez pas de placer votre classe de déclaration parmi les constantes centinelles

#ifndef LIST_H
#define LIST_H
#include <iostream>
.
.
template <class T>
class list
{
private:
    int m_size,
        m_count_nodes;
    T m_line;
    node<T> *m_head;
public:
    list(void);
    ~list(void);
    void add_end(T);
    void print();
};
#endif