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` не валидира невалиден вход.