Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

ctime — fonction temporelle C23 obsolète

`ctime(timer)` de `<time.h>` convertit le temps civil `time_t` pointé en chaîne d’heure locale et renvoie le pointeur de l’équivalent `asctime(localtime(timer))`. En C23, la déclaration est `[[deprecated]]` ; cette fonction obsolescente est à éviter dans le nouveau code.

Version : C23

Syntaxe

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

ctime(timer) de <time.h> convertit le temps civil time_t pointé en chaîne d’heure locale et renvoie le pointeur de l’équivalent asctime(localtime(timer)). En C23, la déclaration est [[deprecated]] ; cette fonction obsolescente est à éviter dans le nouveau code.

L’exemple passe un time_t nul, vérifie le pointeur puis affiche la longueur et le saut de ligne final. Zéro était un temps valide sur la plate-forme testée ; C ne définit ni son époque ni son encodage. Le format de 25 caractères ne vaut qu’après conversion réussie en temps décomposé dont l’année va de 1000 à 9999. Hors de ce domaine, le comportement de asctime est indéfini ; un test NULL ultérieur ne valide donc pas une entrée invalide.

Le tampon renvoyé peut être écrasé par une conversion ultérieure utilisant le même objet ; ces fonctions ne sont pas réentrantes et ne doivent pas nécessairement éviter leurs data races mutuelles. Accéder au pointeur après la fin du thread appelant est UB. Préférez localtime_r avec votre struct tm, puis strftime dans votre tampon.

Exemples

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

Résultat

25 1

L’exemple passe un `time_t` nul, vérifie le pointeur puis affiche la longueur et le saut de ligne final. Zéro était un temps valide sur la plate-forme testée ; C ne définit ni son époque ni son encodage. Le format de 25 caractères ne vaut qu’après conversion réussie en temps décomposé dont l’année va de 1000 à 9999. Hors de ce domaine, le comportement de `asctime` est indéfini ; un test `NULL` ultérieur ne valide donc pas une entrée invalide.

Sources