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.