CKTIS / C
ctime — przestarzała funkcja czasu C23
`ctime(timer)` z `<time.h>` przekształca wskazany czas kalendarzowy `time_t` na napis czasu lokalnego i zwraca wskaźnik zwrócony przez odpowiednik `asctime(localtime(timer))`. W C23 deklaracja ma `[[deprecated]]`; funkcja jest obsolescent i należy jej unikać w nowym kodzie.
Wersja: C23
Składnia
[[deprecated]] char *ctime(const time_t *timer);ctime(timer) z <time.h> przekształca wskazany czas kalendarzowy time_t na napis czasu lokalnego i zwraca wskaźnik zwrócony przez odpowiednik asctime(localtime(timer)). W C23 deklaracja ma [[deprecated]]; funkcja jest obsolescent i należy jej unikać w nowym kodzie.
Przykład przekazuje time_t równy zeru, sprawdza wskaźnik i drukuje długość oraz obecność końcowego znaku nowej linii. Na testowanej platformie zero było poprawnym czasem; C nie określa jego epoki ani kodowania. Format 25 znaków obowiązuje tylko po udanej konwersji do czasu rozłożonego z rokiem 1000–9999. Poza tą dziedziną zachowanie asctime jest niezdefiniowane, więc późniejsze sprawdzenie NULL nie waliduje niepoprawnego wejścia.
Zwrócony bufor może zostać nadpisany przez kolejne wywołanie funkcji czasu używającej tego samego obiektu; te funkcje nie są reentrant i nie muszą unikać wzajemnych data race. Dostęp przez wskaźnik po zakończeniu wywołującego wątku jest UB. W nowym kodzie użyj localtime_r z własnym struct tm, a tekst utwórz przez strftime we własnym buforze.
Przykłady
#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;
}
Wynik
25 1
Przykład przekazuje `time_t` równy zeru, sprawdza wskaźnik i drukuje długość oraz obecność końcowego znaku nowej linii. Na testowanej platformie zero było poprawnym czasem; C nie określa jego epoki ani kodowania. Format 25 znaków obowiązuje tylko po udanej konwersji do czasu rozłożonego z rokiem 1000–9999. Poza tą dziedziną zachowanie `asctime` jest niezdefiniowane, więc późniejsze sprawdzenie `NULL` nie waliduje niepoprawnego wejścia.