База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

ctime — остаряла функция за време в C23

`ctime(timer)` от `<time.h>` преобразува посоченото календарно време `time_t` в низ за местно време и връща указателя от еквивалента `asctime(localtime(timer))`. В C23 декларацията е `[[deprecated]]`; функцията е остаряла и трябва да се избягва в нов код.

Версия: C23

Синтаксис

[[deprecated]] char *ctime(const time_t *timer);

ctime(timer) от <time.h> преобразува посоченото календарно време time_t в низ за местно време и връща указателя от еквивалента asctime(localtime(timer)). В C23 декларацията е [[deprecated]]; функцията е остаряла и трябва да се избягва в нов код.

Примерът подава нулево time_t, проверява указателя и отпечатва дължината и крайния нов ред. Нулата беше валидно време на тестваната платформа; C не определя нито епохата, нито кодирането му. Форматът от 25 знака важи само след успешно преобразуване до разбито време с година от 1000 до 9999. Извън тази област поведението на asctime е неопределено, затова последваща проверка за NULL не валидира невалиден вход.

Върнатият буфер може да бъде презаписан от следващо преобразуване със същия обект; функциите не са reentrant и не са длъжни взаимно да избягват data race. Достъпът след края на извикващата нишка е UB. Нов код трябва да използва localtime_r със собствен struct tm, после strftime в собствен буфер.

Примери

#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;
}

Резултат

25 1

Примерът подава нулево `time_t`, проверява указателя и отпечатва дължината и крайния нов ред. Нулата беше валидно време на тестваната платформа; C не определя нито епохата, нито кодирането му. Форматът от 25 знака важи само след успешно преобразуване до разбито време с година от 1000 до 9999. Извън тази област поведението на `asctime` е неопределено, затова последваща проверка за `NULL` не валидира невалиден вход.

Източници