Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

ctime — função de tempo C23 obsoleta

`ctime(timer)` de `<time.h>` converte o tempo de calendário `time_t` apontado numa cadeia de hora local e devolve o ponteiro do equivalente `asctime(localtime(timer))`. Em C23 é declarada `[[deprecated]]`; é obsoleta e deve ser evitada em código novo.

Versão: C23

Sintaxe

[[deprecated]] char *ctime(const time_t *timer);

ctime(timer) de <time.h> converte o tempo de calendário time_t apontado numa cadeia de hora local e devolve o ponteiro do equivalente asctime(localtime(timer)). Em C23 é declarada [[deprecated]]; é obsoleta e deve ser evitada em código novo.

O exemplo passa um time_t zero, verifica o ponteiro e imprime o comprimento e o newline final. Zero era um tempo válido na plataforma testada; C não define a sua época nem codificação. O formato de 25 caracteres só se aplica após conversão bem-sucedida para tempo decomposto com ano entre 1000 e 9999. Fora desse domínio, asctime tem comportamento indefinido, pelo que uma verificação posterior de NULL não valida uma entrada inválida.

O buffer devolvido pode ser sobrescrito por outra conversão que use o mesmo objeto; estas funções não são reentrantes nem têm de evitar data races entre si. Aceder pelo ponteiro após terminar a thread chamadora é UB. Usa localtime_r com um struct tm próprio e depois strftime num buffer próprio.

Exemplos

#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;
}

Resultado

25 1

O exemplo passa um `time_t` zero, verifica o ponteiro e imprime o comprimento e o newline final. Zero era um tempo válido na plataforma testada; C não define a sua época nem codificação. O formato de 25 caracteres só se aplica após conversão bem-sucedida para tempo decomposto com ano entre 1000 e 9999. Fora desse domínio, `asctime` tem comportamento indefinido, pelo que uma verificação posterior de `NULL` não valida uma entrada inválida.

Fontes