WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen