CKTIS / C
ctime — zastaraná časová funkcia C23
`ctime(timer)` z `<time.h>` prevedie odkazovaný kalendárny čas `time_t` na reťazec miestneho času a vráti ukazovateľ z ekvivalentu `asctime(localtime(timer))`. V C23 má deklarácia `[[deprecated]]`; funkcia je zastaraná a v novom kóde sa jej vyhnite.
Verzia: C23
Syntax
[[deprecated]] char *ctime(const time_t *timer);ctime(timer) z <time.h> prevedie odkazovaný kalendárny čas time_t na reťazec miestneho času a vráti ukazovateľ z ekvivalentu asctime(localtime(timer)). V C23 má deklarácia [[deprecated]]; funkcia je zastaraná a v novom kóde sa jej vyhnite.
Príklad odovzdá nulový time_t, overí ukazovateľ a vypíše dĺžku a koncový nový riadok. Nula bola na testovanej platforme platným časom; C neurčuje jej epochu ani kódovanie. Formát 25 znakov platí len po úspešnom prevode na rozložený čas s rokom 1000 až 9999. Mimo tejto oblasti má asctime nedefinované správanie, takže následná kontrola NULL neoverí neplatný vstup.
Vrátený buffer môže prepísať neskoršia časová konverzia používajúca rovnaký objekt; funkcie nie sú reentrantné a nemusia medzi sebou brániť data race. Prístup po ukončení volajúceho vlákna je UB. V novom kóde použite localtime_r s vlastným struct tm a potom strftime do vlastného buffera.
Príklady
#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;
}
Výsledok
25 1
Príklad odovzdá nulový `time_t`, overí ukazovateľ a vypíše dĺžku a koncový nový riadok. Nula bola na testovanej platforme platným časom; C neurčuje jej epochu ani kódovanie. Formát 25 znakov platí len po úspešnom prevode na rozložený čas s rokom 1000 až 9999. Mimo tejto oblasti má `asctime` nedefinované správanie, takže následná kontrola `NULL` neoverí neplatný vstup.