Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje