sous-routine wcsftime

Editer en ligne

Objectif

Convertit la date et l'heure en une chaîne de caractères larges.

Bibliothèque

Bibliothèque C standard (Libc. A)

Syntaxe

#include <time.h>
size_t wcsftime (WcString, Maxsize, Format, TimPtr)
wchar_t * WcString;
size_t  Maxsize;
const wchar_t * Format;
const struct tm * TimPtr;

Descriptif

La fonction Wcsftime est équivalente à la fonction Strftime , sauf que:

  • L'argument Wcs pointe vers l'élément initial d'un tableau de caractères larges dans lesquels la sortie générée doit être placée.
  • L'argument Tamax_max indique le nombre maximal de caractères larges à placer dans le tableau de sortie.
  • L'argument Format est une chaîne de caractères larges et les spécifications de conversion sont remplacées par des séquences correspondantes de caractères larges.
  • La valeur de retour indique le nombre de caractères larges placés dans le tableau de sortie.

Si la copie a lieu entre des objets qui se chevauchent, le comportement n'est pas défini.

Paramètres

Article Descriptif
WcString Contient la sortie de la sous-routine Wcsftime .
Taille maximale Indique le nombre maximal d'octets (y compris l'octet de fin NULL de caractère large) pouvant être placés dans le paramètre WcString .
Format Les spécificateurs sont les mêmes que dans la fonction Strftime (Sous-routine strftime ou strftime_l).
TimPtr Contient les données à convertir par le sous-programme Wcsftime .

Valeurs renvoyées

Si l'opération aboutit et si le nombre de caractères larges résultant (y compris l'octet de fin de caractère large) n'est pas supérieur au nombre d'octets spécifié par le paramètre Maxsize , la sous-routine wcsftime renvoie le nombre de caractères larges (à l'exclusion de l'octet de fin de caractère large) placés dans le paramètre WcString . Sinon, 0 est renvoyé et le contenu du paramètre WcString est indéterminé.