std::chrono::is_clock

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

日期和时间库

时间点 time_point (C++11) clock_time_conversion (C++20)   clock_cast (C++20) 时长 duration (C++11) 时钟 system_clock (C++11) steady_clock (C++11) is_clock (C++20) utc_clock (C++20) tai_clock (C++20) high_resolution_clock (C++11) gps_clock (C++20) file_clock (C++20) local_t (C++20) 当天时刻 is_amis_pm (C++20)(C++20) make12make24 (C++20)(C++20) hh_mm_ss (C++20)

日历 day (C++20) month (C++20) year (C++20) weekday (C++20) operator/ (C++20) year_month_day (C++20) year_month_day_last (C++20) year_month_weekday (C++20) year_month_weekday_last (C++20)   weekday_indexed (C++20) weekday_last (C++20) month_day (C++20) month_day_last (C++20) month_weekday (C++20) month_weekday_last (C++20) year_month (C++20) last_speclast (C++20)(C++20) chrono I/O parse (C++20)

时区 tzdb (C++20) tzdb_list (C++20) get_tzdbget_tzdb_listreload_tzdbremote_version (C++20)(C++20)(C++20)(C++20) sys_info (C++20) local_info (C++20) nonexistent_local_time (C++20) ambiguous_local_time (C++20) locate_zone (C++20) current_zone (C++20) time_zone (C++20) choose (C++20) zoned_traits (C++20) zoned_time (C++20) time_zone_link (C++20) leap_second (C++20) leap_second_info (C++20) get_leap_second_info (C++20) C 风格日期和时间

 

在标头 <chrono> 定义
template< class T > struct is_clock;		(C++20 起)

如果 T 满足时钟 (Clock) ，那么提供等于 true 的成员常量 value，对于任何其他类型，value 是 false。

就此特征而言，不指定实现确定类型不能满足时钟 (Clock) 的其他要求，但至少保证 T 在没有满足以下所有条件时不应当有资格作为时钟 (Clock) ：

• 以下每个有限定的标识符都合法，并且代表一个类型：

• T::rep
• T::period
• T::duration
• T::time_point

• 以下每个表达式在作为不求值操作数时都良构：

• T::is_steady
• T::now()

如果程序添加了 std::is_clock 或 std::is_clock_v 的特化，那么行为未定义。

模板形参

T

-

要检查的类型

辅助变量模板

template< class T > constexpr bool is_clock_v = is_clock<T>::value;		(C++20 起)

继承自 std::integral_constant

成员常量

value [静态]

如果 T 满足时钟 (Clock) 要求那么是 true，否则是 false (公开静态成员常量)

成员函数

operator bool	将对象转换到 bool，返回 value (公开成员函数)
operator() (C++14)	返回 value (公开成员函数)

成员类型

类型	定义
value_type	bool
type	std::integral_constant<bool, value>

可能的实现

template<class> struct is_clock : std::false_type {};   template<class T> requires requires { typename T::rep; typename T::period; typename T::duration; typename T::time_point; T::is_steady; // 不检查类型 T::now(); // 不检查返回类型 } struct is_clock<T> : std::true_type {};

注解

如果 T 满足了时钟 (Clock) 规定，但 T::is_steady 的类型不是 const bool，或者 T::now() 的类型不是 T::time_point，那么不指明 is_clock_v<T> 的结果。

示例

运行此代码

#include <chrono>
#include <ratio>
 
static_assert
(
    std::chrono::is_clock_v<std::chrono::utc_clock> and
    not std::chrono::is_clock_v<std::chrono::duration<int, std::exa>>
);
 
int main() {}