Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti