Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti