CKTIS / C
timespec_get — tijd ophalen
timespec_get slaat de tijd op in een struct timespec. Controleer de retourwaarde voordat u de velden leest; een weergave in nanoseconden garandeert geen resolutie van één nanoseconde.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <time.h>
int timespec_get(struct timespec *ts, int base);timespec_get uit <time.h> slaat de tijd op in het object waar ts naar wijst. Geef het adres van een beschrijfbare struct timespec door. Bij succes wordt base teruggegeven; bij een fout wordt 0 teruggegeven. Lees in dat geval de velden niet uit.
Bij TIME_UTC bevat tv_sec het aantal seconden sinds een door de implementatie bepaalde epoch, die niet noodzakelijk de Unix-epoch is. tv_nsec bevat nanoseconden, afgerond op de resolutie van de klok; de eenheid garandeert geen nauwkeurigheid.
TIME_UTC garandeert geen monotonie. C23 definieert TIME_MONOTONIC niet als gestandaardiseerde tijdbasis, ook niet als optionele tijdbasis. Een implementatie kan extra tijdbasissen definiëren; hun beschikbaarheid en gedrag hangen af van de implementatie.
Voorbeelden
#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;
}Resultaat
valid nanoseconds
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.