Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

timespec_get — pobieranie czasu

timespec_get zapisuje czas w struct timespec. Sprawdź wynik przed odczytem pól; nanosekundowa reprezentacja nie gwarantuje nanosekundowej rozdzielczości.

Wersja: C23; repository compiler flag, production runtime not attested

Składnia

#include <time.h>
int timespec_get(struct timespec *ts, int base);

timespec_get z <time.h> zapisuje czas w obiekcie wskazanym przez ts. Przekaż adres zapisywalnego struct timespec. Sukces zwraca base, niepowodzenie — 0; wtedy nie odczytuj pól.

Dla TIME_UTC pole tv_sec zawiera sekundy od epoki zależnej od implementacji, niekoniecznie uniksowej. Pole tv_nsec zawiera nanosekundy zaokrąglone do rozdzielczości zegara; jednostka nie gwarantuje dokładności.

TIME_UTC nie gwarantuje monotoniczności. C23 nie definiuje TIME_MONOTONIC jako standardowej podstawy czasu, nawet opcjonalnej. Implementacja może definiować dodatkowe podstawy czasu; ich dostępność i działanie zależą od implementacji.

Przykłady

#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;
}

Wynik

valid nanoseconds

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła