Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje