Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

ctime — zastarela časovna funkcija C23

`ctime(timer)` iz `<time.h>` pretvori navedeni koledarski čas `time_t` v niz lokalnega časa in vrne kazalec iz ekvivalenta `asctime(localtime(timer))`. V C23 je deklaracija `[[deprecated]]`; funkcija je zastarela in naj se v novi kodi ne uporablja.

Različica: C23

Sintaksa

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

ctime(timer) iz <time.h> pretvori navedeni koledarski čas time_t v niz lokalnega časa in vrne kazalec iz ekvivalenta asctime(localtime(timer)). V C23 je deklaracija [[deprecated]]; funkcija je zastarela in naj se v novi kodi ne uporablja.

Primer poda ničelni time_t, preveri kazalec ter izpiše dolžino in končno novo vrstico. Nič je bil na preizkušeni platformi veljaven čas; C ne določa njegove epohe niti kodiranja. Oblika 25 znakov velja le po uspešni pretvorbi v razčlenjeni čas z letom od 1000 do 9999. Zunaj tega območja je vedenje asctime nedefinirano, zato poznejše preverjanje NULL ne potrdi neveljavnega vhoda.

Vrnjeni medpomnilnik lahko prepiše poznejša časovna pretvorba z istim objektom; funkcije niso reentrantne in jim med seboj ni treba preprečiti data race. Dostop po koncu klicne niti je UB. Nova koda naj uporabi localtime_r z lastnim struct tm, nato strftime v lasten medpomnilnik.

Primeri

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

Rezultat

25 1

Primer poda ničelni `time_t`, preveri kazalec ter izpiše dolžino in končno novo vrstico. Nič je bil na preizkušeni platformi veljaven čas; C ne določa njegove epohe niti kodiranja. Oblika 25 znakov velja le po uspešni pretvorbi v razčlenjeni čas z letom od 1000 do 9999. Zunaj tega območja je vedenje `asctime` nedefinirano, zato poznejše preverjanje `NULL` ne potrdi neveljavnega vhoda.

Viri