CKTIS / C
ctime — zastaralá časová funkce C23
`ctime(timer)` z `<time.h>` převede odkazovaný kalendářní čas `time_t` na řetězec místního času a vrátí ukazatel z ekvivalentu `asctime(localtime(timer))`. V C23 má deklarace `[[deprecated]]`; funkce je zastaralá a v novém kódu se jí vyhněte.
Verze: C23
Syntaxe
[[deprecated]] char *ctime(const time_t *timer);ctime(timer) z <time.h> převede odkazovaný kalendářní čas time_t na řetězec místního času a vrátí ukazatel z ekvivalentu asctime(localtime(timer)). V C23 má deklarace [[deprecated]]; funkce je zastaralá a v novém kódu se jí vyhněte.
Příklad předá nulový time_t, ověří ukazatel a vypíše délku a koncový nový řádek. Nula byla na testované platformě platným časem; C neurčuje její epochu ani kódování. Formát 25 znaků platí jen po úspěšném převodu na rozložený čas s rokem 1000 až 9999. Mimo tuto oblast má asctime nedefinované chování, takže následná kontrola NULL neověří neplatný vstup.
Vrácený buffer může přepsat pozdější časová konverze používající stejný objekt; funkce nejsou reentrantní a nemusí mezi sebou bránit data race. Přístup po ukončení volajícího vlákna je UB. V novém kódu použijte localtime_r s vlastním struct tm a poté strftime do vlastního bufferu.
Pří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ýsledek
25 1
Příklad předá nulový `time_t`, ověří ukazatel a vypíše délku a koncový nový řádek. Nula byla na testované platformě platným časem; C neurčuje její epochu ani kódování. Formát 25 znaků platí jen po úspěšném převodu na rozložený čas s rokem 1000 až 9999. Mimo tuto oblast má `asctime` nedefinované chování, takže následná kontrola `NULL` neověří neplatný vstup.