函数模板

提升

提升 (lifting) 是指从一个或多个具体的普通函数出发，提取出一个抽象的函数模板 (function template) 的过程。这是一种特殊的泛化 (generalization)。

标准库算法是提升和函数模板的典型示例。

语法

模板形参 T 的实际类型将根据 compare 的静态调用方式在编译期确定：

template <typename T>  // 模板形参列表
int compare(const T& v1, const T& v2) {
  if (v1 < v2) return -1;
  if (v2 < v1) return 1;
  return 0;
}

inline、constexpr 等修饰符应当位于模板形参列表与返回值类型之间，习惯上它们置于第二行行首：

template <typename T>
inline T min(const T&, const T&);

建议	目的
尽量减少对 `T` 的要求	扩大函数模板的适用范围
用 `const T&` 作为函数形参类型	支持不可拷贝类型
只用 `<` 进行比较操作	`T` 不必支持其他运算符

对函数重载的影响

编译器首先根据类型转换次数对所有待选函数（普通函数、模板实例）进行排序：

如果正好有一个函数的匹配程度比其他函数更高，则它将被选中。
如果匹配程度最高的函数有多个，则
- 如果其中只有一个普通函数，则选中该函数。
- 如果都是模板实例，则选中特例化程度更高的实例。
- 否则，该调用有歧义，编译时会报错。

类型推断

显式模板实参

template <typename T1, typename T2, typename T3>
T1 sum(T2 x, T3 y) {
  return x + y;
}

这里的 T2 和 T3 可以由函数实参推断，而 T1 必须显式给出：

int i = 0;
long l = 1;
auto ll = sum<long long>(i, l);  // long long sum(int, long)

函数模板的地址

使用函数模板的地址时，必须确保所有模板形参可以被唯一地确定：

template <typename T>
int compare(const T&, const T&);

// T 可以被唯一地确定为 int，pf1 指向 compare<int> 的地址
int (*pf1)(const int&, const int&) = compare;

// 重载的 func, 均以函数指针为形参类型：
void func(int(*)(const double&, const double&));
void func(int(*)(const int&, const int&));
func(compare<int>);  // 正确：T 被唯一地确定为 int
func(compare);       // 错误：T 无法被唯一地确定

类模板

template <typename T>
class Blob {
 public:
  typedef T value_type;
  typedef typename std::vector<T>::size_type size_type;
  Blob();
  Blob(std::initializer_list<T> il);
  size_type size() const {
    return data_->size();
  }
  bool empty() const {
    return data_->empty();
  }
  void push_back(const T& t) {
    data_->push_back(t);
  }
  void push_back(T&& t) {
    data_->emplace_back(std::move(t));
  }
  void pop_back();
  T& back();
  T& operator[](size_type i);
 private:
  std::shared_ptr<std::vector<T>> data_;
  // throws msg if data_->at(i) is not valid:
  void check(size_type i, const std::string& msg) const;
};

定义成员函数

类模板的成员函数可以在类的内部或外部定义。在内部定义的成员函数是隐式内联的 (inline)。

在外部定义成员函数

在类模板外部定义的成员函数以 template 关键词 + 类模板形参列表开始，例如：

template <typename T>
void Blob<T>::check(size_type i, const std::string& msg) const {
  if (i >= data_->size())
    throw std::out_of_range(msg);
}
template <typename T>
T& Blob<T>::back() {
  check(0, "back on empty Blob");
  return data_->back();
}
template <typename T>
T& Blob<T>::operator[](size_type i) {
  check(i, "subscript out of range");
  return (*data_)[i];
}
template <typename T>
void Blob<T>::pop_back() {
  check(0, "pop_back on empty Blob");
  data_->pop_back();
}

在外部定义构造函数

template <typename T>
Blob<T>::Blob()
    : data_(std::make_shared<std::vector<T>>()) {
}
template <typename T>
Blob<T>::Blob(std::initializer_list<T> il)
    : data_(std::make_shared<std::vector<T>>(il)) {
}

使用第二个构造函数时，初始化列表的元素类型必须与模板类型实参兼容：

Blob<string> articles = {"a", "an", "the"};  // const char* 可以转化为 string

定义 `static` 数据成员

Foo 的每个模板实例都有其静态（数据或方法）成员实例：

template <typename T>
class Foo {
 public:
  static std::size_t count() {
    return count_;
  }
 private:
  static std::size_t count_;
};

而每个静态数据成员都有且仅有一个定义。因此，类模板的静态数据成员应当像成员函数一样，在类的外部给出唯一的定义：

template <typename T>
std::size_t Foo<T>::count_ = 0;  // 定义并初始化 count_

使用类模板名

在内部使用类名

不带模板实参的类模板名 (name of a class template) 不是一种类型名 (name of a type)，但在类模板自己的作用域内，可以省略模板实参列表：

template <typename T>
class BlobPtr/* BlobPtr 是类模板名，BlobPtr<T> 才是类型名 */ {
 public:
  BlobPtr()
      : curr_(0) {
  }
  BlobPtr(Blob<T>& a, std::size_t sz = 0)
      : wptr_(a.data_), curr_(sz) {
  }
  T& operator*() const {
    auto sptr = check(curr_, "dereference past end");
    return (*sptr)[curr_];  // (*sptr) is the vector to which this object points
  }
  // 返回值类型写为 BlobPtr& 而不是 BlobPtr<T>&
  BlobPtr& operator++(int);
  BlobPtr& operator--(int);

 private:
  // check returns a shared_ptr to the vector if the check succeeds 
  std::shared_ptr<std::vector<T>> check(std::size_t, const std::string&) const;
  // store a weak_ptr, which means the underlying vector might be destroyed 
  std::weak_ptr<std::vector<T>> wptr_;
  std::size_t curr_;  // current position within the array
};

其中，自增自减运算符的返回值类型可以写为 BlobPtr& 而不是 BlobPtr<T>&，这是因为在类模板作用域内，编译器将类模板名视为带有模板实参的类型名：

// 相当于
BlobPtr<T>& operator++(int);
BlobPtr<T>& operator--(int);

在外部引用类名

在类模板外部定义成员时，类模板的作用域始于（带模板实参的）类名。因此在 :: 之前需要显式写出模板实参，而在其之后则不用：

template <typename T>
BlobPtr<T> BlobPtr<T>::operator++(int) {
  BlobPtr ret = *this;  // save the current value
  ++*this;  // advance one element; prefix ++ checks the increment
  return ret;  // return the saved state
}

类模板别名 (C++11)

类模板的实例是一种具体类型。用 typedef 可以为类型名定义别名，但对模板名则不可以：

typedef Blob<string> StrBlob;  // OK
typedef std::map TreeMap;      // error

C++11 允许用 using 为类模板定义别名：

// twin 仍是类模板：
template<typename T>
using twin = pair<T, T>;
// authors 的类型是 pair<string, string>
twin<string> authors;

这一机制可以用来固定一个或多个模板形参：

// 固定第二个类型:
template <typename T>
using partNo = pair<T, unsigned>;
// books 的类型是 pair<string, unsigned>
partNo<string> books;

`friend`

友元 (friend) 机制破坏了类的封装，因此要尽量少用。

如果类模板的友元不是模板，那么它对该模板的所有实例都是友元。

如果友元本身就是一个模板，那么友元关系有以下几种可能。

一一对应的模板友元

// 前置声明:
template <typename T>
class BlobPtr;

template <typename T>
class Blob;

template <typename T>
bool operator==(const Blob<T>&, const Blob<T>&);

template <typename T>
class Blob {
  // 以 Blob 的模板实参作为友元的模板形参：
  friend class BlobPtr<T>;
  friend bool operator==<T>(const Blob<T>&, const Blob<T>&);
  // BlobPtr<T> 和 operator==<T> 是 Blob<T> 的友元
};

一般与特定的模板友元

友元可以是一个类模板的所有或特定的实例：

template <typename T>
class Pal1;  // 前置声明

class C {
  // 特定实例 Pal1<C> 是 C 的友元：
  friend class Pal1<C>;
  // 任意实例 Pal2<T> 是 C 的友元，不需要前置声明 Pal2：
  template <typename T>
  friend class Pal2;
};

template <typename T>
class Pal2;  // 前置声明

template <typename T>
class C2 {
  // 特定实例 Pal1<T> 是 C2<T> 的友元，需要前置声明 Pal1：
  friend class Pal1<T>;
  // 任意实例 Pal2<X> 是 C2<T> 的友元，需要前置声明 Pal2：
  template <typename X>
  friend class Pal2;
  // 普通类 Pal3 是 C2<T> 的友元，不需要前置声明 Pal3：
  friend class Pal3;
};

以模板类型实参为友元 (C++11)

template <typename Type>
class Bar {
  friend Type;
};

成员模板

普通类的成员模板

为普通类定义函数成员模板：

#include <cstdio>
class MyDeleter {
 public:
  MyDeleter(std::ostream& s = std::cerr)
      : os(s) {
  }
  template <typename T> void operator()(T* p) const {
    printf("deleting %p\n", p);
    delete p; 
  }
 private:
  std::ostream& os;
};

MyDeleter 型的对象可以用于替代 delete 运算符：

int* ip = new int;
MyDeleter()(ip);  // 临时对象

MyDeleter del;
std::unique_ptr<int, MyDeleter> dp(new int, del);

类模板的成员模板

为类模板声明函数模板成员，二者拥有各自独立的模板形参：

template <typename T>
class Blob {
  template <typename Iter>
  Blob(Iter b, Iter e);
};

如果在类模板的外部定义函数成员模板，应当

先给出类模板的形参列表

再给出成员模板的形参列表

template <typename T>
template <typename Iter>
Blob<T>::Blob(Iter b, Iter e)
  : data_(std::make_shared<std::vector<T>>(b, e)) {
}

模板形参

类型形参

在模板形参列表中，关键词 class 与 typename 没有区别：

template <typename T, class U>
int calc(const T&, const U&);

非类型形参

非类型形参的值在编译期确定（显式指定或由编译器推断），因此必须为常量表达式 (constexpr)：

template<unsigned N, unsigned M>
int compare(const char (&p1)[N], const char (&p2)[M]) {
  return strcmp(p1, p2);
}
// 如果以如下方式调用
compare("hi", "mom");
// 该模板将被实例化为
int compare(const char (&p1)[3], const char (&p2)[4]);

模板形参的作用域

模板形参遵循一般的作用域规则，但已经被模板形参占用的名称在模板内部不得被复用：

typedef double A;

template <typename A, typename B> 
void f(A a, B b) {
  A tmp = a;  // tmp 的类型为模板形参 A 而不是 double
  double B;   // 错误：B 已被模板形参占用，不可复用
}
// 错误：复用模板形参名
template <typename V, typename V>  // ...

模板声明

与函数形参类似，同一模板的模板形参在各处声明或定义中的名称不必保持一致。

一个文件所需的所有模板声明，应当集中出现在该文件头部，并位于所有用到这些模板名的代码之前。

模板形参的类型成员

默认情况下，编译器认为由 :: 获得的名字不是一个类型。因此，如果要使用模板形参的类型成员，必须用关键词 typename 加以修饰：

// T 为一种 容器类型, 并且拥有一个类型成员 value_type
template <typename T>
typename T::value_type top(const T& c) {
  if (!c.empty())
    return c.back();
  else
    return typename T::value_type();
}

默认模板实参 (C++11)

template <typename T, typename F = std::less<T>>
int compare(const T& v1, const T& v2, F f = F()) {
  if (f(v1, v2)) return -1;
  if (f(v2, v1)) return 1;
  return 0;
}

调用时, 可以（而非必须）为其提供一个比较器:

bool i = compare(0, 42);
bool j = compare(item1, item2, compareIsbn);

如果为所有模板形参都指定了默认模板实参，并且希望用它们来创建默认实例，则必须在模板名后面紧跟 <>，例如：

template <class T = int>
class Numbers {
 public:
  Numbers(T v = 0)
      : val(v) {
  }
 private:
  T val; 
};
Numbers<long double> lots_of_precision;
Numbers<> average_precision;  // Numbers<> 相当于 Numbers<int>

实例化 (Instantiation)

C++ 程序的构建过程可以笼统分为以下两步：

编译 (compile)：由编译器将源文件转化为目标文件。
链接 (link)：由链接器将一个或多个目标文件转化为一个可执行文件。

实例化

模板定义是一种特殊的源码，其中含有待定的模板形参，因此编译器无法立即生成目标码。如果模板在定义后被使用，则编译器将对其进行实例化 (instantiation)：

根据上下文确定模板实参：
- 对于函数模板，编译器（通常）会利用函数实参来推断模板实参。如果所有的模板实参都可以被推断出来，则不必显式地指定。
- 对于类模板，必须显式地指定模板实参。
用模板实参替换模板形参，定义出具体的类或函数。
将其编译为目标码：
- 对于函数模板，编译器（通常）会为源文件中的每一种模板实参组合生成一个独立的实例 (instance)，对应于目标文件中的一段目标码。
- 对于类模板，编译器（通常）只会为那些被使用了的成员函数生成实例。

显式实例化 (C++11)

对于一个模板，必须知道其定义才能进行实例化。因此，通常将模板的定义置于头文件（.h 或 .hpp）中。这样做的好处是代码简单，错误容易在编译期被发现。缺点是容易造成目标代码冗余，即相同目标码重复出现在多个目标文件中。

为克服上述缺点，C++11 引入了显式实例化 (explicit instantiation) 机制：

extern template declaration;  // 显式实例声明
       template declaration;  // 显式实例定义

其中 declaration 是一条类或函数的声明，其中的所有模板形参被显式地替换为模板实参。每一条显式实例声明都必须有一条位于其他某个源文件中的显式实例定义与之对应：

对于含有显式实例声明的源文件，与之对应的目标文件不含该实例的目标码。
对于含有显式实例定义的源文件，与之对应的目标文件含有该实例的目标码。
- 类模板的显式实例定义将导致该类模板的所有成员函数（含内联函数）全部被实例化。
这种对应关系将在链接期进行检查。

示例

/* application.cc */
// 隐式实例化：
Blob<int> a1 = {0,1,2,3,4,5,6,7,8,9};
Blob<int> a2(a1);
// 显式实例声明：
extern template class Blob<string>;
extern template int compare(const int&, const int&);
// 使用上述实例：
Blob<string> sa1, sa2;
int i = compare(a1[0], a2[0]);

编译 application.cc 所得的 application.o 将含有 Blob<int> 的两个构造函数（Blob<int>::Blob(initializer_list<int>) 与 Blob<int>::Blob(Blob const&)）的目标码。

/* template_build.cc */
// 显式实例定义：
template class Blob<string>;  // 所有成员函数将被实例化
template int compare(const int&, const int&);

编译 template_build.cc 所得的 template_build.o 将含有 compare<int>() 及 Blob<string> 的所有成员函数的目标码。

特例化 (Specialization)

函数模板的特例化

假设有以下两个版本的同名函数：

// 【版本一】用于比较两个 任意类型的对象：
template <typename T>
int compare(const T&, const T&);
// 【版本二】用于比较两个 字符串字面值 或 字符数组：
template <std::size_t N, std::size_t M>
int compare(const char (&)[N], const char (&)[M]);

在第二个例子中，模板形参 T 被推断为 const char*，因此比较的是两个地址：

// 传入 字符串字面值，创建并调用 compare(const char (&)[3], const char (&)[4]) 这个实例：
compare("hi", "mom");
// 传入 指向字符常量的指针，创建并调用 compare(const char*&, const char*&) 这个实例：
const char* p1 = "hi";
const char* p2 = "mom";
compare(p1, p2);

为了使这种情形下的语义变为比较两个 C-style 字符串，应当对版本一进行特例化 (specialization)：

#include <cstring>
template <>  // 为 T == const char* 的情形提供特例
int compare(const char* const& p1, const char* const& p2) {
  return std::strcmp(p1, p2);
}

特例是一种特殊的模板实例，而不是重载同名函数，因此不会影响重载函数的匹配。

模板及其特例化应当在同一个头文件中进行声明，并且应当先给出所有同名模板，再紧随其后给出所有特例。

类模板的特例化

`std::hash` 的特例化 (C++11)

std::hash 是一个类模板，定义在头文件 <functional> 中：

template <class Key>
struct hash;

标准库中的无序容器（例如 std::unordered_set<Key>）以 std::hash<Key> 为其默认散列函数。定义 std::hash 的特例 std::hash<Key>，必须提供：

重载的调用运算符：std::size_t operator()(const Key&) const noexcept
两个类型成员：argument_type 和 result_type，自 C++17 起淘汰。
默认构造函数：std::hash<Key>()，可以采用隐式定义的版本。
拷贝构造函数：std::hash<Key>(std::hash<Key> const&)，可以采用隐式定义的版本。

假设有一个自定义类型 MyKey：

class MyKey {
 public:
  std::size_t hash() const noexcept;
}
bool operator==(const MyKey& lhs, const MyKey& rhs);  // MyKey 必须支持 == 运算符

则 std::hash<Key> 可以定义为

namespace std {
template <>
struct hash<MyKey> {
  typedef MyKey argument_type;
  typedef size_t result_type;
  size_t operator()(const MyKey& key) const noexcept {
    return key.hash();
  }
  // 默认构造函数 和 拷贝构造函数 采用隐式定义的版本
};
}  // namespace std

部分特例化

部分特例化 (Partial Specialization) 又译作偏特化：为类模板指定部分模板实参或模板形参的部分属性，所得结果依然是类模板。

模板元编程中常用的 std::remove_reference 就是通过一系列偏特化（只指定模板形参的部分属性）来实现消除引用语义的：

// 原始版本：
template <class T>
struct remove_reference {
  typedef T type;
};
// 偏特化版本：
template <class T>
struct remove_reference<T&> {
  typedef T type;
};
template <class T>
struct remove_reference<T&&> {
  typedef T type;
};

函数模板 miniWiki