CKTIS / C
time — ottenere l’ora di calendario corrente
La funzione time di <time.h> restituisce un’approssimazione dell’ora di calendario corrente come time_t; controlla che il risultato non sia (time_t)(-1).
Versione: C23; repository compiler flag, production runtime not attested
Sintassi
#include <time.h>
time_t time(time_t *timer);time restituisce la migliore approssimazione dell’ora di calendario corrente disponibile nell’implementazione. Se l’ora non è disponibile, restituisce (time_t)(-1). Controlla questo risultato prima di usare il valore.
La chiamata time(NULL) restituisce soltanto il risultato. Con un puntatore non nullo, come in time(&stored), la funzione memorizza anche il valore restituito nell’oggetto time_t puntato.
La codifica dell’ora non è specificata: il codice portabile non può presumere che si tratti di secondi dall’epoca Unix. L’esempio confronta il valore memorizzato con quello restituito, invece di stampare una data che cambia.
Esempi
#include <stdio.h>
#include <time.h>
int main(void)
{
time_t stored;
time_t result = time(&stored);
if (result == (time_t)(-1)) {
puts("Time unavailable");
return 1;
}
puts(stored == result ? "Values match" : "Values differ");
return 0;
}Risultato
Values match
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.