CKTIS / C
timespec_get — ottenere l’ora
timespec_get memorizza l’ora in una struct timespec. Controlla il valore restituito prima di leggere i campi; la rappresentazione in nanosecondi non garantisce una risoluzione al nanosecondo.
Versione: C23; repository compiler flag, production runtime not attested
Sintassi
#include <time.h>
int timespec_get(struct timespec *ts, int base);timespec_get di <time.h> memorizza l’ora nell’oggetto puntato da ts. Passa l’indirizzo di una struct timespec scrivibile. In caso di successo restituisce base; in caso di errore restituisce 0. In quest’ultimo caso, non leggere i campi.
Con TIME_UTC, tv_sec contiene i secondi trascorsi da un’epoca definita dall’implementazione, che non è necessariamente l’epoca Unix. tv_nsec contiene nanosecondi arrotondati alla risoluzione dell’orologio; l’unità non garantisce accuratezza.
TIME_UTC non garantisce la monotonicità. C23 non definisce TIME_MONOTONIC come base temporale standard, nemmeno come base facoltativa. Un’implementazione può definire basi temporali aggiuntive; la loro disponibilità e il loro comportamento dipendono dall’implementazione.
Esempi
#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;
}Risultato
valid nanoseconds
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.