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.