Linker-Fehler 'nicht aufgelöstes externes Symbol': Arbeiten mit Vorlagen

Question

Ich habe eine Vorlage basiert Klasse [Allotter.h & Allotter.cpp]:

template <typename allotType> class Allotter { 
public: 
Allotter(); 
quint32 getAllotment(allotType*); 
bool removeAllotment(quint32, int auto_destruct = 0); 

private: 
QVector<QPair<quint32, allotType*>> indexReg; 
int init_topIndex; 
}; 

und es ist Nutzung ist als [ActiveListener.h & ActiveListener. cpp]:

class ActiveListener: public QObject { 
Q_OBJECT 

public: 
ActiveListener(); 

private slots: 
    void processConnections(); 
    void readFromSocket(int); 

private: 
QTcpServer* rootServer; 
QSignalMapper* signalGate; 
Allotter<QTcpSocket> TcpAllotter; 
}; 

Ich zeige nicht die vollständigen Definitionen, da es nicht wirklich wichtig ist. Das Problem ist, wenn ich kompiliere, alle Dateien richtig kompilieren. Die Dateien befinden sich in einem VC++ - Projekt. Früher, als ich keinen Vorlagen-basierten Ansatz für Allotter verwendet habe, war alles Kompilieren und Verknüpfen in Ordnung. Aber jetzt bekomme ich diesen Fehler:

1>ActiveListener.obj : error LNK2019: unresolved external symbol "public: __thiscall Allotter<class QTcpSocket>::Allotter<class QTcpSocket>(void)" (??0?$Allotter@VQTcpSocket@@@@QAE@XZ) referenced in function "public: __thiscall ActiveListener::ActiveListener(void)" (??0ActiveListener@@QAE@XZ) 
1>ActiveListener.obj : error LNK2019: unresolved external symbol "public: unsigned int __thiscall Allotter<class QTcpSocket>::getAllotment(class QTcpSocket *)" (?getAllotment@?$Allotter@VQTcpSocket@@@@QAEIPAVQTcpSocket@@@Z) referenced in function "private: void __thiscall ActiveListener::processConnections(void)" (?processConnections@ActiveListener@@AAEXXZ) 

Die überraschende Sache ist, dass der Konstruktor, ActiveListener::ActiveListener() keinen Hinweis auf allen Allotter<QTcpSocket>::Allotter() macht. Die zweite Referenz existiert jedoch. Aber ich verstehe nicht, warum der Linker dieses externe Symbol nicht auflösen kann.

Die Build-Ausgabe, kurz bevor die Fehler angezeigt ist:

1>Moc'ing ActiveListener.h... 
1>Compiling... 
1>stdafx.cpp 
1>Compiling... 
1>ActiveListener.cpp 
1>Allotter.cpp 
1>moc_ActiveListener.cpp 
1>main.cpp 
1>Generating Code... 
1>Linking... 

Ich verstehe nicht, wenn irgendetwas davon relevant ist, vor allem, weil alles perfekt bevor sie zur Arbeit eingesetzt. Es ist nur so, dass nach der Verwendung von Vorlagen ein Problem verursacht wird. Jede Hilfe wird geschätzt. Danke vielmals.

Answer 1

Sie können Vorlagen nicht in .h- und .cpp-Dateien aufteilen. Sie müssen den vollständigen Code für die Vorlage in die .h-Datei einfügen.

Answer 2

Da Sie die Vorlagenimplementierung nicht in CPP-Dateien platzieren können, wird empfohlen, .INL-Dateien für die Vorlagenimplementierung zu verwenden und sie aus den Vorlagenheadern aufzunehmen.

Answer 3

Im Allgemeinen gilt es als bewährte Methode, den Vorlagencode vollständig in die Header-Dateien zu schreiben. Es gibt einen wichtigen technischen Grund dafür: Wenn Sie eine Vorlage instanziieren, muss der C++ - Compiler Code aus dieser Vorlage generieren, die für die von Ihnen angegebenen Vorlagenparameter spezifisch ist. Wenn Ihr Vorlagencode vollständig in Ihren Kopfzeilen platziert ist, geschieht dies automatisch für Sie.

Es ist ist definitiv möglich, Vorlagencode die Art zu schreiben, die Sie haben, mit der Implementierung in cpp-Dateien platziert. Wenn Sie dies jedoch tun, müssen Sie die Vorlageninstanz, die Sie verwenden möchten, explizit instanziieren.

In Ihrem Fall müssen Sie die folgende Zeile in eine CPP-Datei in einem Projekt hinzuzufügen:

template class Allotter<QTcpSocket>;