为什么这个模板示例代码没有编译?

时间:2014-04-15 16:05:43

标签: c++ templates lnk2019

我正在尝试使用模板来学习如何使用它们。我在Visual Studio 2010 C ++中创建了一个包含三个文件的项目:

Controller.cpp:

#include <iostream>

#include "Foo.h"

using namespace std;

int main(){

    Example<int,string> example;

    example.appols(5, "Hi");

    return 0;
}

foo.h中:

#include <iostream> 

using namespace std;

template <class T, class E>
class Foo{
public:
    void printThis(T t, E e);
};

template <class T, class E>
class Example{
public:
    void appols(T t, E e);
};

Foo.ipp:

#include <iostream>

#include "Foo.h"

using namespace std;

template<class T, class E>
void Foo<T, E>::printThis(T t, E e){
    cout << "FOO! " << t << ' ' << e << endl;
}

template<class T, class E>
void Example<T, E>::appols(T t, E e){
    cout << "APPOLS!! " << t << ' ' << e << endl;
    Foo<T,E> f;
    f.printThis(t,e);
}

当我尝试编译时,我得到:

1>------ Build started: Project: Template Practive, Configuration: Debug Win32 ------
1>Controller.obj : error LNK2019: unresolved external symbol "public: void __thiscall Example<int,class std::basic_string<char,struct std::char_traits<char>,class std::allocator<char> > >::appols(int,class std::basic_string<char,struct std::char_traits<char>,class std::allocator<char> >)" (?appols@?$Example@HV?$basic_string@DU?$char_traits@D@std@@V?$allocator@D@2@@std@@@@QAEXHV?$basic_string@DU?$char_traits@D@std@@V?$allocator@D@2@@std@@@Z) referenced in function _main
1>C:\Users\Matthew\documents\visual studio 2010\Projects\Template Practive\Debug\Template Practive.exe : fatal error LNK1120: 1 unresolved externals
========== Build: 0 succeeded, 1 failed, 0 up-to-date, 0 skipped ==========

你能帮助我看看我在这里做错了什么以及error LNK2019来自哪里? 提前谢谢!

1 个答案:

答案 0 :(得分:5)

解密错误消息

让我们先尝试解码错误信息:

1>Controller.obj : error LNK2019: unresolved external symbol 
"public: void __thiscall Example<int,class std::basic_string<char,struct
std::char_traits<char>,class std::allocator<char> > >::appols(int,class
std::basic_string<char,struct std::char_traits<char>,class std::allocator<char> >)"
(?appols@?$Example@HV?$basic_string@DU?$char_traits@D@std@@V?$allocator@D@2@@std@@@@QAEXHV?$basic_string@DU?$char_traits@D@std@@V?$allocator@D@2@@std@@@Z) 
referenced in function _main

我们可以在此错误消息中开始降低噪声/信号比率。

(?appols@?$Example@HV?$basic_string@DU?$char_traits@D@std@@...的部分只是C ++ 名称修改。它适用于C ++编译器,并不是人类可读的东西。所以我们可以放弃它。

简化的错误消息变为:

1>Controller.obj : error LNK2019: unresolved external symbol 
"public: void __thiscall Example<int,class std::basic_string<char,struct
std::char_traits<char>,class std::allocator<char> > >::appols(int,class
std::basic_string<char,struct std::char_traits<char>,class std::allocator<char> >)"
referenced in function _main

第一行告诉我们有一个“未解析的外部符号”。让我们尝试识别它,看下一行。

部分:

class std::basic_string<char,struct std::char_traits<char>...

只是std::string的长名称(对应于std::basic_string模板,char作为字符类型并使用默认的char特征和默认分配器)。

因此,我们可以进一步减少噪音,用std::string代替那些冗长的部分:

1>Controller.obj : error LNK2019: unresolved external symbol 
"public: void __thiscall Example<int,string>::appols(int,string)"
referenced in function _main

现在错误更清楚了。

__thiscall部分只是C ++成员函数默认使用的调用约定。

因此,链接器抱怨这种方法:

"public: void Example<int,string>::appols(int,string)"

对应于您的Example<T,E>::appols()

template <class T, class E>
class Example{
public:
    void appols(T t, E e);
};

T=intE=std::string

这与您在Controller.cpp中的main()函数中的内容相对应:

Example<int,string> example;

example.appols(5, "Hi");

问题的诊断和解决方案

问题是所有模板源代码必须位于头文件中,而不是.cpp文件中。

实际上,编译器需要定义模板代码才能实例化它。

因此,您可以将代码从Foo.ipp文件移动到Foo.h(或者只是从Foo.h中移动#include "Foo.ipp"),并将inline添加到模板函数定义中:

// New code in Foo.h

template<class T, class E>
inline void Foo<T, E>::printThis(T t, E e){
    cout << "FOO! " << t << ' ' << e << endl;
}

template<class T, class E>
inline void Example<T, E>::appols(T t, E e){
    cout << "APPOLS!! " << t << ' ' << e << endl;
    Foo<T,E> f;
    f.printThis(t,e);
}

另请注意,using namespace std;在头文件中确实很糟糕,因为这会污染包含头文件的所有客户端的全局命名空间。只需在头文件中明确使用std::前缀(例如:std::coutstd::endl等)。