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 でサポートされている場合、base が提供する時間の分解能を *ts に格納します。サポートされている各 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	エポックからの時間としてシステムの現在のカレンダー時間を返す (関数)