std::chrono::high_resolution_clock

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (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風格日期和時間

 

std::chrono::high_resolution_clock

成員函式

high_resolution_clock::now

 

定義於標頭檔案 <chrono>
class high_resolution_clock;		(C++11 起)

類 std::chrono::high_resolution_clock 表示由實現提供的具有最小 tick 週期（即最高解析度）的時鐘。它可能是 std::chrono::system_clock 或 std::chrono::steady_clock 的別名，或者是第三個獨立的自有時鐘。

std::chrono::high_resolution_clock 滿足 TrivialClock 的要求。

成員型別

型別	定義
rep	表示時鐘持續時間中 tick 數量的算術型別
period	一個 std::ratio 型別，表示時鐘的“滴答”週期，以秒為單位
duration	std::chrono::duration<rep, period>
time_point	std::chrono::time_point<std::chrono::high_resolution_clock>

成員常量

constexpr bool is_steady [靜態]

如果 tick 之間的時間總是恆定的，即 now() 的呼叫返回即使在某些外部時鐘調整的情況下也單調遞增的值，則為 true，否則為 false (public static 成員常量)

成員函式

now [靜態]

返回一個 std::chrono::time_point，表示時鐘的當前值 (公共靜態成員函式)

注意

關於 high_resolution_clock 的使用一直存在爭議。Howard Hinnant 聲稱他將 high_resolution_clock 引入了該語言，在 2016 年在 ISO C++ 標準 - 討論郵件列表上表示他贊成棄用它。他的理由是，因為標準允許它作為 std::chrono::steady_clock 或 std::chrono::system_clock 的別名，其使用會給程式增加不確定性而無益。然而，該執行緒中的其他參與者表示支援它，例如，基於 std::chrono::steady_clock 和 std::chrono::system_clock 都沒有任何特定的解析度保證，high_resolution_clock 透過為供應商提供機會來提供平臺最高解析度的時鐘而發揮著有益的作用，因為其 std::chrono::steady_clock 和 std::chrono::system_clock 都不是最高解析度的時鐘。

它通常只是 std::chrono::steady_clock 或 std::chrono::system_clock 的別名，但具體是哪一個取決於庫或配置。當它是 system_clock 時，它不是單調的（例如，時間可以倒退）。例如，截至 2023 年，libstdc++ 將其別名為 system_clock，“直到高於納秒的定義變得可行”，MSVC 將其作為 steady_clock，而 libc++ 在 C++ 標準庫實現支援單調時鐘時使用 steady_clock，否則使用 system_clock。

另請參閱

system_clock (C++11)	系統範圍即時時鐘的掛鐘時間 (類)
steady_clock (C++11)	永不調整的單調時鐘 (類)