实例化 C++模板函数

Question

我面临一些“未定义引用”错误的问题。我可能无法发布代码，但声明和我调用函数的方式如下：

声明：

template <typename T>
int pitch_detect(deque<T>& x, int offset, int len);

template <typename T>
int is_voiced(
  deque<T>& x, int offset, int len,
  double avg_energy, int pre_voice,
  short& s_flag,
  long nsamples
);

我按如下方式调用上述函数：

x = is_voiced(superFrame_, cur_offset_, f_len_,
    avgEnergy_, frame_voicing_[1], silence_flag_, nsamples_);

y = pitch_detect(superFrame_, cur_offset_, f_len_);

上述语句（我调用函数的位置）被标记作为错误。这些是消息：

对 `int 的未定义引用 is_voiced(std::deque >&, int, int, 双精度型、整数型、短型和长型）

对 `int 的未定义引用 itch_Detect(std::deque >&, int, int)'

非常欢迎解码上述错误的任何帮助。 谢谢， 斯里拉姆

编辑： 上述函数定义在单独的头文件和相应的 C++ 文件中。当我尝试编译它们并创建目标文件时，我没有遇到任何问题。这些错误出现在链接器阶段。

Answer 1

您是否提供了这些模板的定义？您是自己显式实例化模板还是允许编译器实例化它们？

如果您提供模板声明，但编译器在同一翻译单元中看不到定义，它将假定该模板将在另一个翻译单元中实例化，并且只会生成调用，但不会编译（看不到定义）不可能做到）具体实例化。稍后在链接时，链接器将看到该调用，但不会看到实例化，并且会因未定义引用错误而失败。

最简单的解决方案是将模板声明和定义放在一起：

template <typename T>
int is_voiced( deque<T>& x, int offset, int len, double avg_energy, int pre_voice, short& s_flag, long nsamples ) 
{
  // code here
}

然后，当您使用 is_voiced(...) 时，编译器将隐式为您实例化模板（它会看到代码，并会编译它） ）。

在某些情况下，您不希望编译器隐式实例化您的模板（您知道将使用什么类型，并且您不希望编译器允许其他用途——或者编译成本很高并且想要仅通过在单个翻译单元中实例化模板来加快编译速度）。对于这些情况，您将需要在翻译单元中提供您自己的显式实例化。

// header
template <typename T>
int is_voiced( deque<T>& x, int offset, int len, double avg_energy, int pre_voice, short& s_flag, long nsamples ); 

// cpp
template <typename T>
int is_voiced( deque<T>& x, int offset, int len, double avg_energy, int pre_voice, short& s_flag, long nsamples ) {
   // code goes here
}
// explicit instantiation for int
template int is_voiced( deque<int>& x, int offset, int len, double avg_energy, int pre_voice, short& s_flag, long nsamples );

然后编译该实现文件并将其与项目的其余部分链接。

注意：建议在标头中提供完整的模板定义，以便编译器可以隐式实例化它，除非您有充分的理由不这样做。

Answer 2

将函数的定义放在头文件中，而不是放在单独的 CPP 文件中；并且，在头文件中，在函数定义前面添加 inline 关键字，以避免链接器抱怨重复的定义。

Answer 3

我没有尝试过 g++，但是你尝试过显式命名类型吗？

x = is_voiced<PutTypeNameHere>(superFrame_, etc);

定义和调用是从同一个 dll/exe 完成的吗？如果没有，您可能需要使用调用模板函数的类型显式实例化它们。