CKTIS / C
ctime — funzione temporale C23 deprecata
`ctime(timer)` di `<time.h>` converte il tempo di calendario `time_t` puntato in una stringa di ora locale e restituisce il puntatore dell’equivalente `asctime(localtime(timer))`. In C23 è dichiarata `[[deprecated]]`; è obsolescente e va evitata nel nuovo codice.
Versione: C23
Sintassi
[[deprecated]] char *ctime(const time_t *timer);ctime(timer) di <time.h> converte il tempo di calendario time_t puntato in una stringa di ora locale e restituisce il puntatore dell’equivalente asctime(localtime(timer)). In C23 è dichiarata [[deprecated]]; è obsolescente e va evitata nel nuovo codice.
L’esempio passa un time_t zero, controlla il puntatore e stampa lunghezza e newline finale. Zero era un tempo valido sulla piattaforma provata; C non ne definisce epoca né codifica. Il formato di 25 caratteri vale solo dopo una conversione riuscita in tempo scomposto con anno tra 1000 e 9999. Fuori da questo dominio il comportamento di asctime è indefinito, quindi un successivo controllo di NULL non convalida un input non valido.
Il buffer restituito può essere sovrascritto da una conversione successiva che usa lo stesso oggetto; queste funzioni non sono rientranti e non devono evitare data race reciproche. Accedere al puntatore dopo l’uscita del thread chiamante è UB. Usa localtime_r con un proprio struct tm, poi strftime in un buffer posseduto.
Esempi
#include <stdio.h>
#include <string.h>
#include <time.h>
int main(void) {
time_t moment = 0;
char *text = ctime(&moment);
if (text == NULL) return 1;
size_t length = strlen(text);
printf("%zu %d\n", length, length > 0 && text[length - 1] == '\n');
return 0;
}
Risultato
25 1
L’esempio passa un `time_t` zero, controlla il puntatore e stampa lunghezza e newline finale. Zero era un tempo valido sulla piattaforma provata; C non ne definisce epoca né codifica. Il formato di 25 caratteri vale solo dopo una conversione riuscita in tempo scomposto con anno tra 1000 e 9999. Fuori da questo dominio il comportamento di `asctime` è indefinito, quindi un successivo controllo di `NULL` non convalida un input non valido.