asctime_r, _wasctime_r
Remonter à Time.h - Index
Fichier d'en-tête
time.h
Catégorie
Routines date et heure
Prototype
errno_t asctime_r(char *s, rsize_t maxsize, const struct tm *tmPtr);
errno_t wasctime_r(wchar_t *s, rsize_t maxsize, const struct tm *tmPtr);
Description
Remplace asctime en ajoutant des améliorations relatives à la sécurité.
asctime_r convertit la date et l'heure en ASCII.
wasctime_r convertit la date et l'heure en une chaîne wchar_t.
asctime_r et wasctime_r convertissent une heure stockée sous forme d'une structure en une chaîne de 26 caractères de large au format suivant :
Lun Nov 21 11:31:54 1983\n\0
Tous les champs ont une largeur constante. Les chaînes de sortie day-of-the-week et month correspondent aux lignes suivantes :
tm parameterValid value rangeOutput
tm.mon (month)0-110=Jan, 1=Fév, et ainsi de suite
tm.day (day-of-the-week)0-60=Dim, 1=Lun, et ainsi de suite
Si une violation de contrainte d'exécution se produit, s[0] est alors défini sur null.
Valeur de retour
asctime_r et wasctime_r renvoient zéro en cas de réussite. Sinon, une valeur différente de zéro est renvoyée.
Exemple
#include <string.h>
#include <time.h>
#include <stdio.h>
int main(void)
{
struct tm t;
char str[80];
/* Sample loading of tm structure */
t.tm_sec = 1; /* Seconds */
t.tm_min = 30; /* Minutes */
t.tm_hour = 9; /* Hour */
t.tm_mday = 22; /* Day of the Month */
t.tm_mon = 4; /* Month */
t.tm_year = 120;/* Year - does not include century */
t.tm_wday = 4; /* Day of the week */
t.tm_yday = 0; /* Does not show in asctime */
t.tm_isdst = 0; /* Is Daylight SavTime; does not show in asctime */
/* Converts structure to null-terminated string */
asctime_r(&t, str);
printf("%s\n", str);
return 0;
}
Portabilité
POSIX | Win32 | ANSI C | ANSI C++ | |
---|---|---|---|---|
asctime_r |
+ |
+ |
+ |
+ |
wasctime_r |
+ |