CKTIS / C
ctime — verouderde C23-tijdfunctie
`ctime(timer)` uit `<time.h>` zet de aangewezen `time_t`-kalendertijd om in een lokale-tijdstring en retourneert de pointer van het equivalent `asctime(localtime(timer))`. In C23 is de declaratie `[[deprecated]]`; de verouderde functie hoort niet in nieuwe code.
Versie: C23
Syntax
[[deprecated]] char *ctime(const time_t *timer);ctime(timer) uit <time.h> zet de aangewezen time_t-kalendertijd om in een lokale-tijdstring en retourneert de pointer van het equivalent asctime(localtime(timer)). In C23 is de declaratie [[deprecated]]; de verouderde functie hoort niet in nieuwe code.
Het voorbeeld geeft een nul-time_t, controleert de pointer en drukt lengte en laatste newline af. Nul was op het geteste platform een geldige tijd; C legt epoch noch codering vast. Het formaat van 25 tekens geldt alleen na geslaagde omzetting naar een opgebroken tijd met een jaar van 1000 tot en met 9999. Buiten dat domein is het gedrag van asctime ongedefinieerd, dus een latere NULL-controle valideert geen ongeldige invoer.
De resultaatbuffer kan worden overschreven door een latere tijdconversie die hetzelfde object gebruikt; deze functies zijn niet reentrant en hoeven onderling data races niet te vermijden. Toegang nadat de aanroepende thread eindigt is UB. Gebruik localtime_r met een eigen struct tm en daarna strftime in een eigen buffer.
Voorbeelden
#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;
}
Resultaat
25 1
Het voorbeeld geeft een nul-`time_t`, controleert de pointer en drukt lengte en laatste newline af. Nul was op het geteste platform een geldige tijd; C legt epoch noch codering vast. Het formaat van 25 tekens geldt alleen na geslaagde omzetting naar een opgebroken tijd met een jaar van 1000 tot en met 9999. Buiten dat domein is het gedrag van `asctime` ongedefinieerd, dus een latere `NULL`-controle valideert geen ongeldige invoer.