asctime_s, wasctime_s

Remonter à time.h - Index

Fichier en-tête

time.h

Catégorie

Routines date et heure

Prototype

errno_t asctime_s(char *s, rsize_t maxsize, const struct tm *tmPtr);
errno_t wasctime_s(wchar_t *s, rsize_t maxsize, const struct tm *tmPtr);

Description

Remplace asctime en ajoutant des améliorations relatives à la sécurité.

asctime_s convertit la date et l'heure en ASCII.

wasctime_s convertit la date et l'heure en une chaîne wchar_t.

asctime_s et wasctime_s 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 renvoyée

asctime_s et wasctime_s renvoient zéro en cas de succès. 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    = 11; /* Month */
  t.tm_year   = 56; /* 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_s(str, 50, &t);
  printf("%s\n", str);
  return 0;
}

Portabilité

	POSIX	Win32	ANSI C	ANSI C++
asctime_s	+	+	+	+
wasctime_s		+

Voir aussi

• Bibliothèque C sécurisante