Skip to main content

Chapter 41: Concepts

核心问题与阅读主线

本章导读8 个核心小节 · 附自检与总结

未约束模板的类型错误往往延迟到函数体、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编译期检测一组类型或表达式要求,求值为 boolconcept 定义体或布尔常量表达式中检查成员访问、嵌套类型、返回类型与额外约束

下面两个声明都将 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_rangebegin/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 则以“声明关联约束是否满足”过滤候选,二者在约束位置、诊断入口与重载偏序上存在本质差异:

维度SFINAEconcepts工程影响
约束位置分散在返回类型、默认模板参数、辅助 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 对应映射):

  1. 确定实际操作:先明确算法真正依赖的遍历与访问行为(仅单遍顺序遍历)。
  2. 选最小标准概念:按最低够用原则选择标准 concept(选用 std::ranges::input_range)。
  3. 补齐专属表达式:用 requires expression 描述项目特有成员或调用(HasIntegralId 检查 value.id)。
  4. 收紧结果类型:用 std::integral、std::convertible_to 或 std::same_as 约束类型(ID 族用 std::integral,限定 int 则用 std::same_as<id_member_t<T>, int>)。
  5. 校验重载强弱:确认多个重载之间的概念存在明确蕴含关系,避免原子约束无法归一化导致的歧义。

最小自检任务​

动手自检先独立判断

判断 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_v SFINAE,但包含 bool 与字符类型,且不校验运行时数值与业务规则。

  • std::ranges 分层约束

    input_range 等概念组合了 begin/end 与 iterator 能力,按算法实际操作选最小概念,无需过度要求 random_access_range 或 view。

  • SFINAE 与 STL 分工

    C++20 起对外接口约束优先使用 concepts,SFINAE、traits 与 if constexpr 留作旧标准兼容及库内部实现分支。