CKTIS / C
timespec_get — Zeit abrufen
timespec_get speichert die Zeit in einer struct timespec. Prüfen Sie den Rückgabewert, bevor Sie die Felder auslesen; eine Darstellung in Nanosekunden garantiert keine Nanosekunden-Auflösung.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <time.h>
int timespec_get(struct timespec *ts, int base);timespec_get aus <time.h> speichert die Zeit in dem Objekt, auf das ts zeigt. Übergeben Sie die Adresse einer beschreibbaren struct timespec. Bei Erfolg wird base zurückgegeben, bei einem Fehler 0; lesen Sie in diesem Fall die Felder nicht aus.
Bei TIME_UTC enthält tv_sec die Sekunden seit einer implementierungsdefinierten Epoche, die nicht unbedingt der Unix-Epoche entspricht. tv_nsec enthält Nanosekunden, gerundet auf die Auflösung der Uhr; die Einheit garantiert keine Genauigkeit.
TIME_UTC garantiert keine Monotonie. C23 definiert TIME_MONOTONIC nicht als standardisierte Zeitbasis, auch nicht als optionale. Eine Implementierung kann zusätzliche Zeitbasen definieren; ihre Verfügbarkeit und ihr Verhalten hängen von der Implementierung ab.
Beispiele
#include <stdio.h>
#include <time.h>
int main(void)
{
struct timespec ts;
if (timespec_get(&ts, TIME_UTC) != TIME_UTC) {
puts("unavailable");
return 1;
}
puts(ts.tv_nsec >= 0 && ts.tv_nsec < 1000000000L
? "valid nanoseconds" : "invalid nanoseconds");
return 0;
}Ergebnis
valid nanoseconds
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.