std::clock

< cpp‎ | chrono‎ | c
 
C++
 
工具库
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
(C++14)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)(C++20)(C++20)(C++20)
(C++20)
swap 与类型运算
(C++20)
(C++14)
(C++11)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)

初等字符串转换
(C++17)
(C++17)
(C++17)
 
日期和时间工具
(C++11)
(C++11)
当天时刻
(C++20)



(C++20)(C++20)(C++20)(C++20)
时钟
(C++11)
(C++11)
(C++11)
(C++20)
                                             
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
日历
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
时区
(C++20)
(C++20)
(C++20)(C++20)(C++20)(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
C 风格日期和时间
 
C 风格日期和时间工具
函数
时间操作
clock
(C++17)
格式转换
常量
类型
(C++17)
 
定义于头文件 <ctime>
std::clock_t clock();

返回进程从关联到程序执行的实现定义时期开始，所用的粗略处理器时间。为转换结果为秒，可将它除以 CLOCKS_PER_SEC 。

只有二次不同的 std::clock 调用所返回的值之差才有意义，因为 std::clock 时期的开始不必与程序的起始一致。 std::clock 可能前进快于或慢于挂钟，取决于操作系统给予程序的执行资源。例如，若与其他进程共享 CPU ，则 std::clock 时间的前进可能慢于壁钟。另一方面，若当前进程为多线程，且多于一个执行核心可用，则 std::clock 时间的前进可能快于壁钟。

参数

（无）

返回值

程序迄今为止所用的处理器时间。若该信息不可用，或若其值无法表示，则为 (std::clock_t)(-1) 。

异常

（无）

注解

在兼容 POSIX 的系统上，带时钟 id CLOCK_PROCESS_CPUTIME_ID 的 clock_gettime 提供更高的解析度。

clock() 返回的值会在一些不遵从的实现上回卷。例如在某种实现上，若 std::clock_t 为有符号 32 位整数而 CLOCKS_PER_SEC 为 1000000 ，则它将在约 2147 秒（约 36 分）后回卷。

示例

此示例演示 clock() 时间与真实时间的差异

运行此代码
#include <iostream>
#include <iomanip>
#include <chrono>
#include <ctime>
#include <thread>
 
// 函数 f() 做一些耗时工作
void f()
{
    volatile double d = 0;
    for(int n=0; n<10000; ++n)
       for(int m=0; m<10000; ++m)
           d += d*n*m;
}
 
int main()
{
    std::clock_t c_start = std::clock();
    auto t_start = std::chrono::high_resolution_clock::now();
    std::thread t1(f);
    std::thread t2(f); // 在二个线程上调用 f()
    t1.join();
    t2.join();
    std::clock_t c_end = std::clock();
    auto t_end = std::chrono::high_resolution_clock::now();
 
    std::cout << std::fixed << std::setprecision(2) << "CPU time used: "
              << 1000.0 * (c_end-c_start) / CLOCKS_PER_SEC << " ms\n"
              << "Wall clock time passed: "
              << std::chrono::duration<double, std::milli>(t_end-t_start).count()
              << " ms\n";
}

可能的输出： 

CPU time used: 1590.00 ms
Wall clock time passed: 808.23 ms

参阅

 转换 time_t 对象为文本表示
(函数)
返回自纪元起计的系统当前时间
(函数)