Cライブラリ関数 -timespec_get()

C 标准库 - <time.h>C標準ライブラリ - <time.h>

説明

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() 関数の使用法を示しています。

例

#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>C標準ライブラリ - <time.h>

その他の拡張