Why does it throw an "unresolved external symbol" error when using class templates?

Question

C++ / C#

Good day!
I'm trying to use a template class:

TemplateClass.h

#pragma once
#include <iostream>
#include <boost/asio/ip/tcp.hpp>

template <class T>
class TemplateClass {
public:
  TemplateClass();
  ~TemplateClass();
};

TemplateClass.cpp

#include "pch.h"
#include "TemplateClass.h"


template <class T>
TemplateClass<T>::TemplateClass() { }

template <class T>
TemplateClass<T>::~TemplateClass() { }

main.cpp

#include "pch.h"
#include <iostream>
#include "TemplateClass.h"

int main() {
  TemplateClass<boost::asio::ip::tcp::socket>* test = new TemplateClass<boost::asio::ip::tcp::socket>();
}

Gives an error when compiling:

Screenshot

Text option

• Серьезность Код Описание Проект Файл Строка Состояние подавления
  Ошибка (активно) E2512 Аргумент для тестирования функции макро должен быть простым идентификатором. TemplateClassErrorTest D:\cpp\libraries\boost_1_68_0\boost\system\error_code.hpp 401
  
• Серьезность Код Описание Проект Файл Строка Состояние подавления
  Ошибка LNK2001 неразрешенный внешний символ ""public: __cdecl TemplateClass >::TemplateClass >(void)" ([email protected][email protected]@[email protected]@[email protected]@@[email protected]@@@@[email protected])" TemplateClassErrorTest D:\cpp\Tests\TemplateClassErrorTest\TemplateClassErrorTest\TemplateClassErrorTest.obj 1
  
• Серьезность Код Описание Проект Файл Строка Состояние подавления
  Ошибка LNK1120 неразрешенных внешних элементов: 1 TemplateClassErrorTest D:\cpp\Tests\TemplateClassErrorTest\x64\Release\TemplateClassErrorTest.exe 1
  

If you transfer the contents of the TemplateClass.cpp file to the TemplateClass.h file, then everything compiles, everything works.
Tell me what's wrong?

Answer 1

Because templates must be declared and defined in a header file (according to the language standard). Transfer everything from cpp to h and everything will work for you.