Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

timespec_get — získání času

timespec_get ukládá čas do struct timespec. Před čtením polí zkontrolujte návratovou hodnotu; reprezentace v nanosekundách nezaručuje rozlišení na nanosekundy.

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

Syntaxe

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

timespec_get z <time.h> ukládá čas do objektu, na který ukazuje ts. Předávejte adresu zapisovatelné struct timespec. Při úspěchu vrací base, při neúspěchu 0; v takovém případě pole nečtěte.

Pro TIME_UTC obsahuje tv_sec počet sekund od epochy určené implementací, která nemusí být unixovou epochou. tv_nsec obsahuje nanosekundy zaokrouhlené na rozlišení hodin; jednotka nezaručuje přesnost.

TIME_UTC nezaručuje monotónnost. C23 nedefinuje TIME_MONOTONIC jako standardní časovou základnu, ani jako volitelnou. Implementace může definovat další časové základny; jejich dostupnost a chování závisí na implementaci.

Příklady

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

Výsledek

valid nanoseconds

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje