База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

timespec_get — получаване на време

timespec_get записва времето в struct timespec. Проверете върнатата стойност, преди да прочетете полетата; представянето в наносекунди не гарантира разделителна способност от наносекунда.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

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

timespec_get от <time.h> записва времето в обекта, към който сочи ts. Подайте адреса на записваема struct timespec. При успех връща base, а при неуспех — 0; в този случай не четете полетата.

При TIME_UTC tv_sec съдържа секундите от епоха, определена от имплементацията, която не е задължително да е Unix епохата. tv_nsec съдържа наносекунди, закръглени до разделителната способност на часовника; единицата не гарантира точност.

TIME_UTC не гарантира монотонност. C23 не определя TIME_MONOTONIC като стандартна времева база, дори като незадължителна. Имплементацията може да дефинира допълнителни времеви бази; тяхната наличност и поведение зависят от имплементацията.

Примери

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

Резултат

valid nanoseconds

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници