CKTIS / C
ctime — veraltete C23-Zeitfunktion
`ctime(timer)` aus `<time.h>` wandelt die bezeichnete `time_t`-Kalenderzeit in eine lokale Zeitzeichenfolge um und liefert den Zeiger des Äquivalents `asctime(localtime(timer))`. In C23 trägt die Deklaration `[[deprecated]]`; die obsoleszente Funktion ist in neuem Code zu vermeiden.
Version: C23
Syntax
[[deprecated]] char *ctime(const time_t *timer);ctime(timer) aus <time.h> wandelt die bezeichnete time_t-Kalenderzeit in eine lokale Zeitzeichenfolge um und liefert den Zeiger des Äquivalents asctime(localtime(timer)). In C23 trägt die Deklaration [[deprecated]]; die obsoleszente Funktion ist in neuem Code zu vermeiden.
Das Beispiel übergibt time_t null, prüft den Zeiger und gibt Länge sowie abschließenden Zeilenumbruch aus. Null war auf der getesteten Plattform eine gültige Zeit; C legt weder Epoche noch Kodierung fest. Das 25-Zeichen-Format gilt nur nach erfolgreicher Umwandlung in eine aufgeschlüsselte Zeit mit einem Jahr von 1000 bis 9999. Außerhalb dieses Bereichs ist das Verhalten von asctime undefiniert; eine spätere NULL-Prüfung validiert daher keine ungültige Eingabe.
Der Ergebnispuffer kann durch einen späteren Zeitumwandlungsaufruf mit demselben Objekt überschrieben werden; diese Funktionen sind nicht reentrant und müssen untereinander keine Data Races vermeiden. Zugriff nach Ende des aufrufenden Threads ist UB. Neuer Code nutzt localtime_r mit eigenem struct tm und strftime in einen eigenen Puffer.
Beispiele
#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;
}
Ergebnis
25 1
Das Beispiel übergibt `time_t` null, prüft den Zeiger und gibt Länge sowie abschließenden Zeilenumbruch aus. Null war auf der getesteten Plattform eine gültige Zeit; C legt weder Epoche noch Kodierung fest. Das 25-Zeichen-Format gilt nur nach erfolgreicher Umwandlung in eine aufgeschlüsselte Zeit mit einem Jahr von 1000 bis 9999. Außerhalb dieses Bereichs ist das Verhalten von `asctime` undefiniert; eine spätere `NULL`-Prüfung validiert daher keine ungültige Eingabe.