timespec_getres

 

C

编译器支持

语言

头文件

类型支持

程序工具

变参函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

日期和时间工具

函数

时间操作

difftime

time

clock

timespec_get (C11)

timespec_getres (C23)

格式转换

asctimeasctime_s (C23 中已废弃)(C11)

ctimectime_s (C23 中已废弃)(C11)

strftime

wcsftime (C95)

gmtimegmtime_rgmtime_s (C23)(C11)

localtimelocaltime_rlocaltime_s (C23)(C11)

mktime

常量

CLOCKS_PER_SEC

类型

tm

time_t

clock_t

timespec (C11)

 

定义于头文件 <time.h>
int timespec_getres( struct timespec *ts, int base );		(自 C23 起)

如果 ts 非空且 base 受 timespec_get 支持，则修改 *ts 以保存 timespec_get 为 base 提供的时间分辨率。对于每个受支持的 base，在同一程序执行期间对 timespec_getres 的多次调用会产生相同的结果。

参数

ts	-	指向 struct timespec 类型对象的指针
base	-	TIME_UTC 或其他非零整数值，表示时间基准

返回值

如果 base 受支持，则返回 base 的值，否则返回零。

注意

POSIX 函数 clock_getres(clock_id, ts) 也可用于用 clock_id 标识的时间分辨率填充 timespec。

示例

运行此代码

#include <stdio.h>
#include <time.h>
 
int main(void)
{
    char buff[128];
    struct timespec ts;
    const int res = timespec_getres(&ts, TIME_UTC);
    if (res == TIME_UTC) {
        struct tm timer;
        strftime(buff, sizeof buff, "%D %T", gmtime_r(&ts.tv_sec, &timer));
        printf("Time resolution info: %s.%09ld UTC\n", buff, ts.tv_nsec);
    } else {
        printf("TIME_UTC base is not supported.");
    }
}

可能的输出

Time resolution info: 01/01/70 00:00:00.000000001 UTC

另请参阅

timespec (C11)	秒和纳秒时间 (结构体)
timespec_get (C11)	根据给定时间基准返回以秒和纳秒表示的日历时间 (函数)
time	返回系统当前日历时间，自纪元起的时间 (函数)