Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

timespec_get — obtenir l’heure

timespec_get stocke l’heure dans une struct timespec. Vérifiez sa valeur de retour avant de lire les champs ; une représentation en nanosecondes ne garantit pas une résolution à la nanoseconde.

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

Syntaxe

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

timespec_get de <time.h> stocke l’heure dans l’objet pointé par ts. Passez l’adresse d’une struct timespec modifiable. En cas de réussite, la fonction renvoie base ; en cas d’échec, elle renvoie 0. Dans ce dernier cas, ne lisez pas les champs.

Avec TIME_UTC, tv_sec contient le nombre de secondes écoulées depuis une époque définie par l’implémentation, qui n’est pas nécessairement l’époque Unix. tv_nsec contient des nanosecondes arrondies à la résolution de l’horloge ; cette unité ne garantit pas l’exactitude.

TIME_UTC ne garantit pas la monotonie. C23 ne définit pas TIME_MONOTONIC comme base de temps normalisée, même facultative. Une implémentation peut définir d’autres bases de temps ; leur disponibilité et leur comportement dépendent de l’implémentation.

Exemples

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

Résultat

valid nanoseconds

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources