KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen