Cライブラリ関数 -timespec_get()
説明
timespec_get()C11 標準で導入された関数であり、現在時刻を取得して、timespec構造体に格納します。この関数は正確な時刻を取得する方法を提供し、通常は高解像度のタイミング操作に使用されます。
宣言
以下は timespec_get() 関数の宣言です。
int timespec_get(struct timespec *ts, int base);
パラメータ
ts:ポインタtimespec構造体へのポインタ。この構造体には現在時刻が格納されます。base:時間基準定数。C11 標準ではTIME_UTC、協定世界時 (UTC) を表します。
戻り値
- 成功時には
baseの値を返します(通常はTIME_UTC)。 - 失敗時には0を返します。
struct timespec構造体
struct timespec {
time_t tv_sec; // 秒
long tv_nsec; // ナノ秒
};
time_t tv_sec; // 秒
long tv_nsec; // ナノ秒
};
例
以下の例は、time() 関数の使用法を示しています。
例
#include <stdio.h>
#include <time.h>
int main() {
struct timespec ts;
if (timespec_get(&ts, TIME_UTC) == TIME_UTC) {
printf("Current time: %ld seconds and %ld nanoseconds since the Epoch\n",
ts.tv_sec, ts.tv_nsec);
} else {
perror("timespec_get failed");
}
return 0;
}
上記のプログラムをコンパイルして実行すると、次の結果が得られます。
Current time: 1718332786 seconds and 358463000 nanoseconds since the Epoch
注意事項
timespec_get()よりtime()高い時間分解能を提供します。これは、返される時間にナノ秒が含まれるためです。- 使用する場合、
timespec_get()コードが C11 標準をサポートする環境で実行されることを確認する必要があります。 timespec_get()の主な用途は、高精度なタイミング計測です。例えば、コードの実行時間の測定、パフォーマンス解析などです。
関連関数
clock_gettime():高解像度の時間を取得するためのもう1つの関数ですが、POSIX サポートが必要です。
理解して使用することでtimespec_get()、高精度な現在時刻を簡単に取得でき、正確なタイミングが必要な場面で、より効率的で正確な C プログラムを記述できます。
C標準ライブラリ - <time.h>