Chapter 41: Concepts
核心问题与阅读主线
未约束模板的类型错误往往延迟到函数体、traits 展开或迭代器运算深处爆发,调用者无法从函数签名看出参数能力边界。C++20 concepts 将类型要求提升到模板声明层,在函数体实例化前完成候选过滤、重载偏序与接口级诊断。
全章共用代码样本(下文各节持续拆解)
贯穿全章的样本是一个收集记录 ID 的泛型函数 collect_ids:它接收任意满足条件的输入 range,并要求元素具备整数型 id 成员。
#include <concepts>
#include <ranges>
#include <type_traits>
#include <utility>
#include <vector>
template<class T>
using id_member_t = std::remove_cvref_t<decltype(std::declval<T>().id)>;
template<class T>
concept HasIntegralId =
requires(T&& value) {
value.id;
} &&
std::integral<id_member_t<T>>;
template<class R>
concept IdRange =
std::ranges::input_range<R> &&
HasIntegralId<std::ranges::range_reference_t<R>>;
template<IdRange R>
auto collect_ids(R&& records)
{
using id_type = id_member_t<std::ranges::range_reference_t<R>>;
std::vector<id_type> result;
for (auto&& record : records) {
result.push_back(record.id);
}
return result;
}
调用 collect_ids 时,编译器先在接口层校验 IdRange、HasIntegralId 与 std::integral;只有约束全部满足,才会进入函数体实例化。
41.1 concepts 为什么出现
未约束模板把类型假设藏在函数体内部。声明 template<class R> auto collect_ids(R&&) 不会暴露对 R 的任何要求,只有实例化函数体里的 record.id 时编译器才会报错。
SFINAE 虽能利用 decltype(std::declval<T>().id)、std::void_t 与 std::enable_if_t 淘汰不匹配候选,却把接口条件分散在返回类型、默认模板参数与辅助 traits 中,调用者需要反向追踪多层别名才能还原真实要求。
Concepts 在声明层引入了可命名的接口约束,在 STL 工程阅读中带来三点变化:
- 接口即契约:标准库算法直接将
input_range、iterator、predicate、relation 等能力要求写进签名,源码读者能从声明推断入口边界。 - 语义可组合:
IdRange将std::ranges::input_range<R>与元素约束HasIntegralId组合成可复用概念,不再堆砌零散表达式检测。 - 诊断前置:传入
std::vector<User>时,编译器在函数体展开前先检查 range 与id成员约束,失败时直接指向未满足的 concept,而非由函数体里的record.id承担第一报错责任。
41.2 requires
requires 关键字承担两种语法角色,在代码中分别控制“何时参与候选”和“检查哪些语法条件”:
| 语法形态 | 角色定位 | 出现位置 | 典型用途 |
|---|---|---|---|
requires clause | 把布尔约束附着到声明 | 模板参数列表后或函数声明尾部 | 控制函数、类或成员模板是否进入可行候选 |
requires expression | 编译期检测一组类型或表达式要求,求值为 bool | concept 定义体或布尔常量表达式中 | 检查成员访问、嵌套类型、返回类型与额外约束 |
下面两个声明都将 HasIntegralId<T> 附着到函数模板上,标准语义完全等价,均作为关联约束参与候选过滤:
template<class T>
requires HasIntegralId<T>
auto id_of(const T& value)
{
return value.id;
}
template<class T>
auto id_of_checked(const T& value) requires HasIntegralId<T>
{
return value.id;
}
- 前置
requires clause:紧贴模板参数列表,适合表达仅依赖模板类型参数的约束。 - 尾置
requires clause:位于函数形参列表之后,适合引用函数参数、返回类型或用于类模板成员函数。
HasIntegralId 的前半段是一个只检查 value.id 能否形成合法表达式的 requires expression,它本身并不限制 id 的类型:
template<class T>
concept HasIdExpression = requires(T&& value) {
value.id;
};
在 requires expression 内部,可以组合简单要求、类型要求、复合要求和嵌套要求四种检查原语:
template<class T>
concept CompactRecord = requires(T value) {
typename T::key_type;
{ value.key() } -> std::same_as<typename T::key_type>;
requires sizeof(T) <= 64;
};
| 要求类别 | 语法示例 | 编译期检查内容 |
|---|---|---|
| 简单要求(simple) | value.id; | 表达式能否合法构成(不实际求值) |
| 类型要求(type) | typename T::key_type; | 嵌套类型或别名模板实例化是否合法 |
| 复合要求(compound) | { value.key() } -> std::same_as<typename T::key_type>; | 表达式合法性、可选 noexcept 与返回类型约束 |
| 嵌套要求(nested) | requires sizeof(T) <= 64; | 在表达式体内附加额外的布尔常量条件 |
边界与误区
在 HasIntegralId 中,requires(T&& value) { value.id; } 必须写在 std::integral<id_member_t<T>> 之前:约束合取 && 按从左到右短路求值,先确认 value.id 合法,右侧 id_member_t<T> 才不会对缺失 id 的类型触发硬替换错误。此外,requires expression 只检验编译期语法与类型条件,不验证运行时业务语义。
41.3 constraint
Constraint 是关联到模板声明的编译期布尔条件,concept 则是命名后的约束集合。函数模板、类模板、变量模板、别名模板以及类模板成员函数均可关联约束,用于控制候选资格与重载偏序。
IdRange 通过 && 组合 std::ranges::input_range<R> 与 HasIntegralId<std::ranges::range_reference_t<R>>,任一条件不满足都会直接把 collect_ids 移出可行候选集。模板调用从实参替换到实例化的过滤路径如下:
当多个受约束候选同时可行时,编译器通过约束蕴含关系选择约束更强的重载。下面两个 scan 重载都能匹配 std::vector<User>,由于 std::ranges::random_access_range 蕴含 std::ranges::input_range,编译器会优先选中约束更强的 random_access_range 重载:
template<std::ranges::input_range R>
void scan(R&& records);
template<std::ranges::random_access_range R>
void scan(R&& records);
约束检查只拦截在候选过滤阶段;进入函数体实例化后,result.push_back(record.id) 仍可能因 id_type 无法放入 std::vector、record.id 访问权限受限或 allocator 约束而失败。
边界与误区
编译器并非任意布尔定理证明器,重载偏序依赖将约束归一化为原子约束集合。两个手写逻辑等价但原子约束来源不同的 requires 表达式无法建立蕴含关系,会导致重载歧义;因此应优先复用标准 concept 或共享命名 concept(如 IdRange)。
41.4 std::same_as
std::same_as<T, U> 要求两个类型完全一致,用于需要精确类型边界的接口(如要求成员声明为 int、成员函数返回 bool 或迭代器引用与内部类型一致),能把隐式转换、代理对象与更宽类型排除在外。
将贯穿示例收窄为“仅接收 int id”时,可将 std::integral 替换为 std::same_as<id_member_t<T>, int>:
template<class T>
concept HasIntId =
requires(T&& value) {
value.id;
} &&
std::same_as<id_member_t<T>, int>;
template<class R>
concept IntIdRange =
std::ranges::input_range<R> &&
HasIntId<std::ranges::range_reference_t<R>>;
HasIntegralId 接收 short、int、long、unsigned、bool 等整数族类型,而 HasIntId 将元素接口契约收窄为归一化后精确等于 int 的成员类型。
std::same_as 也常用于复合要求 { expression } -> Concept;。此类约束检查的是表达式的 decltype((expression)) 形态,因此会保留引用与 cv 限定:
template<class T>
concept HasConstIntIdReference = requires(const T& value) {
{ value.id } -> std::same_as<const int&>;
};
不同约束写法对应的类型匹配精度与适用场景如下:
| 约束写法 | 匹配对象 | 是否容忍隐式转换 / cvref 差异 | 适用判断 |
|---|---|---|---|
std::same_as<id_member_t<T>, int> | id_member_t<T> 剥离 cvref 后的类型 | 精确等于 int(仅成员顶层 cvref 被归一化) | 只关心成员剥离修饰后为 int |
{ value.id } -> std::same_as<const int&> | decltype((value.id)) 表达式结果 | 严格匹配引用类别与 cv 限定 | 需要限定当前表达式的值类别与返回形态 |
std::convertible_to / std::integral | 语义能力或类型族 | 允许同族不同具体类型或可转换类型 | 通用算法与泛型库优先使用语义族约束 |
核心判断
接口设计应先区分“需要语义族还是精确类型”:需要宽泛能力时优先选 std::convertible_to、std::integral 或 range/iterator concepts;只有隐式转换或类型放宽会破坏接口假设时,才使用 std::same_as。
41.5 std::integral
std::integral<T> 在语义上对应 std::is_integral_v<T>,用来约束下标、计数、标志位或数字 ID 等整数族参数。贯穿样本中的 HasIntegralId 即通过它接纳多种整型 ID:
struct User {
int id;
};
struct Order {
unsigned long id;
};
struct Label {
const char* id;
};
static_assert(HasIntegralId<User>);
static_assert(HasIntegralId<Order>);
static_assert(!HasIntegralId<Label>);
User(int)与 Order(unsigned long)均满足 std::integral,而 Label(const char* 指针)在候选检查阶段即被排除。若需进一步收窄整数族,可叠加 std::signed_integral、std::unsigned_integral,或显式排除特定类型(例如剔除 bool):
template<class T>
concept NonBoolIntegral =
std::integral<std::remove_cvref_t<T>> &&
!std::same_as<std::remove_cvref_t<T>, bool>;
在概念层排除非法类型,比在函数体内写 static_assert 更早暴露接口边界。
边界与误区
bool 与字符类型同样满足 std::integral;若接口只接受可参与算术比较的数值整型,必须额外排除它们。此外,std::integral 只替代 std::enable_if_t<std::is_integral_v<T>> 这类编译期类型族过滤,无法表达数值范围、溢出安全、符号业务规则或数据库 ID 存在性等运行时条件。
41.6 std::ranges concepts
std::ranges concepts 将传统迭代器算法隐含的操作假设显式化,直接对 range、iterator、sentinel、谓词与投影施加可组合约束。在贯穿样本中,IdRange 选择了 std::ranges::input_range<R>:
template<class R>
concept IdRange =
std::ranges::input_range<R> &&
HasIntegralId<std::ranges::range_reference_t<R>>;
std::ranges::input_range<R> 要求 R 能通过 std::ranges::begin / std::ranges::end 获取边界,且 std::ranges::iterator_t<R> 满足 std::input_iterator。由于 collect_ids 只需单遍顺序读取成员(不需要随机访问或 size),选择最小足够的 input_range 才能同时兼容 std::vector<User>、std::list<User> 与单遍输入 view。
下表对比常用的 std::ranges 概念及其对 collect_ids 的适用取舍:
| 概念 | 核心要求与对应 Iterator | 适用边界与 collect_ids 取舍 |
|---|---|---|
std::ranges::input_range | begin/end + std::input_iterator | 支持单遍顺序读取;collect_ids 选用此项以最大化兼容 |
std::ranges::forward_range | 多遍保证 + std::forward_iterator | 适合多遍算法;用于 collect_ids 会不必要地排斥单遍输入 |
std::ranges::bidirectional_range | 双向移动 + std::bidirectional_iterator | 适合反向遍历算法;collect_ids 无需此能力 |
std::ranges::random_access_range | 常数步跳跃 + std::random_access_iterator | 适合索引/排序算法;强加给 collect_ids 会淘汰 std::list |
std::ranges::contiguous_range | 连续内存 + std::contiguous_iterator | 仅在需要原始指针与连续缓冲区时使用 |
std::ranges::view | 轻量、可移动、适用于惰性管线 | 服务过滤/转换等适配器;collect_ids 满足 input_range 即可消费 view 与容器,无需强求 view |
边界与误区
对于自定义容器或 view,concept 只能验证语法形状(ranges::begin/ranges::end 查找与 iterator 操作签名)和局部类别要求。单遍 range 的多次遍历行为、悬垂引用风险与元素生命周期等语义承诺,仍须由类型实现者自行保证。
41.7 concepts 与 SFINAE 对比
SFINAE 以“替换失败使候选退出”淘汰模板,concepts 则以“声明关联约束是否满足”过滤候选,二者在约束位置、诊断入口与重载偏序上存在本质差异:
| 维度 | SFINAE | concepts | 工程影响 |
|---|---|---|---|
| 约束位置 | 分散在返回类型、默认模板参数、辅助 traits 中 | 直接写在模板参数、requires clause 或 concept 定义中 | concepts 更容易从声明读出接口条件 |
| 错误入口 | 可能落在内部表达式、traits 展开或算法实现细节中 | 通常落在未满足的命名约束上 | 调用者更容易定位缺失的类型能力 |
| 表达粒度 | 偏向表达“某个替换是否成功” | 偏向表达“类型属于哪个语义类别” | 标准库可用 range、sortable、predicate 组织接口 |
| 重载关系 | 依赖普通重载规则和替换结果 | 约束强弱可参与偏序 | 更强概念可以自然选择更专门实现 |
| 版本边界 | C++11 起大量使用 | C++20 起进入核心语言和标准库 | 旧代码仍保留 SFINAE,现代接口优先 concepts |
若用 SFINAE 表达 HasIntegralId,通常需要额外叠加检测别名、std::void_t 与 std::enable_if_t;改用 concept 后,表达式要求与类型族要求可并排写清,使函数签名直接变为 template<IdRange R>:
template<class T>
concept HasIntegralId =
requires(T&& value) {
value.id;
} &&
std::integral<id_member_t<T>>;
阅读 STL 源码时,看到 std::ranges::input_range、std::sortable、std::predicate、std::indirectly_copyable 等概念名,应直接将其视作算法输入契约。
核心判断
C++20 之后的对外泛型接口约束应优先写成 concepts,让调用者在声明处看清边界;SFINAE、traits 与 if constexpr 则继续用于兼容旧标准或控制库作者内部的分支实现。
41.8 concepts 对 STL 的影响
Concepts 将 STL 算法与组件的要求从“函数体或文档约定”变成了声明层契约,阅读 ranges 算法、iterator 工具、callable 约束与 view 适配器时,应首先读取其 concept 列表:
- 算法声明贴近真实约束:相比旧式
std::sort(first, last)仅靠参数名暗示要求,ranges 版本直接用 concepts 声明对 range、iterator、sentinel、比较器与投影的组合要求。 - 接入检查点显式化:自定义类型接入 STL 时,range 须满足边界与 iterator 概念,可调用对象须满足
invocable、predicate、relation或strict weak order等 callable 约束,减少从报错猜接口的成本。 - 重载分层分派更清晰:标准库可依据
input_range(顺序扫描)、random_access_range(索引与距离)到contiguous_range(连续存储)提供稳定的约束偏序分派条件。 - 诊断就近收敛:向
collect_ids传入std::vector<Label>时,错误直接落在HasIntegralId/std::integral,而非深入到result.push_back(record.id)或id_member_t展开处。
设计与阅读 concepts 接口时,可按以下五步推导声明约束(括号内为 collect_ids 对应映射):
- 确定实际操作:先明确算法真正依赖的遍历与访问行为(仅单遍顺序遍历)。
- 选最小标准概念:按最低够用原则选择标准 concept(选用
std::ranges::input_range)。 - 补齐专属表达式:用
requires expression描述项目特有成员或调用(HasIntegralId检查value.id)。 - 收紧结果类型:用
std::integral、std::convertible_to或std::same_as约束类型(ID 族用std::integral,限定int则用std::same_as<id_member_t<T>, int>)。 - 校验重载强弱:确认多个重载之间的概念存在明确蕴含关系,避免原子约束无法归一化导致的歧义。
最小自检任务
判断 std::vector<User>、std::vector<Token>、std::vector<Label> 分别调用 collect_ids 与 collect_int_ids 时的结果,并指出各自对应的约束依据。
#include <concepts>
#include <ranges>
#include <string>
#include <type_traits>
#include <utility>
#include <vector>
template<class T>
using id_member_t = std::remove_cvref_t<decltype(std::declval<T>().id)>;
template<class T>
concept HasIntegralId =
requires(T&& value) {
value.id;
} &&
std::integral<id_member_t<T>>;
template<class T>
concept HasIntId =
requires(T&& value) {
value.id;
} &&
std::same_as<id_member_t<T>, int>;
template<class R>
concept IdRange =
std::ranges::input_range<R> &&
HasIntegralId<std::ranges::range_reference_t<R>>;
template<class R>
concept IntIdRange =
std::ranges::input_range<R> &&
HasIntId<std::ranges::range_reference_t<R>>;
template<IdRange R>
auto collect_ids(R&& records);
template<IntIdRange R>
auto collect_int_ids(R&& records);
struct User {
int id;
};
struct Token {
bool id;
};
struct Label {
std::string id;
};
本章知识点总结
- 接口契约前置
concepts 将模板实参能力要求提升至声明层,在函数体实例化前完成候选过滤并将报错定位到未满足的约束名。
- requires 双形态
requires clause附着布尔条件到声明并控制候选资格,requires expression在编译期检查表达式、类型、复合返回与嵌套条件。 - 约束归一化与偏序
编译器把约束拆解为原子约束判断蕴含关系以确定重载优先级,复用标准或共享命名 concept 才能保证偏序稳定。
- std::same_as 精确边界
要求两类型完全一致,配合复合要求
{ expr } -> std::same_as<T>时检验的是带引用与 cv 限定的decltype((expr))。 - std::integral 类型族
覆盖整数类型并替代手写
std::is_integral_vSFINAE,但包含bool与字符类型,且不校验运行时数值与业务规则。 - std::ranges 分层约束
input_range等概念组合了begin/end与 iterator 能力,按算法实际操作选最小概念,无需过度要求random_access_range或view。 - SFINAE 与 STL 分工
C++20 起对外接口约束优先使用 concepts,SFINAE、traits 与
if constexpr留作旧标准兼容及库内部实现分支。