_ultoa_s, _ultow_s
Convertit un entier long non signé en une chaîne. Il s'agit de versions de _ultoa, _ultow avec des améliorations de sécurité, comme décrit dans Fonctionnalités de sécurité dans le CRT.
errno_t _ultoa_s(
unsigned long value,
char *str,
size_t sizeOfstr,
int radix
);
errno_t _ultow_s(
unsigned long value,
wchar_t *str,
size_t sizeOfstr,
int radix
);
template <size_t size>
errno_t _ultoa_s(
unsigned long value,
char (&str)[size],
int radix
); // C++ only
template <size_t size>
errno_t _ultow_s(
unsigned long value,
wchar_t (&str)[size],
int radix
); // C++ only
Paramètres
value
Nombre devant être converti.str
Chaîne de résultat.sizeOfstr
La taille de str en octets pour _ultoa_s ou les mots de _ultow_s.radix
Base de value.
Valeur de retour
Zéro si la fonction a réussi ou un code d'erreur.
Notes
La fonction _ultoa_s convertit les chiffres de value en chaîne de caractères se terminant par null et stocke le résultat (jusqu'à 33 octets) dans str. L'argument radix spécifie la base de value, qui doit être comprise entre 2 et 36. _ultow_s est une version à caractères larges de _ultoa_s ; le deuxième argument de _ultow_s est une chaine à caractères larges.
Si str est un pointeur NULL, ou si sizeOfstr est inférieur ou égal à zéro, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation de paramètre. Si l'execution est autorisée à continuer, ces fonctions retournent -1 et errno est défini à EINVAL ou si value ou str sont hors des limites d'un entier long, ces fonctions retournent -1 et définissent errno à la valeur ERANGE.
En C++, l'utilisation de ces fonctions est simplifiée par les surcharges de modèle ; les surcharges peuvent déduire la longueur de la mémoire tampon automatiquement (ce qui évite d'avoir à spécifier un argument taille) et peuvent remplacer automatiquement les fonctions plus anciennes et non sécurisées par leurs équivalentes plus récentes et sécurisées. Pour plus d'informations, consultez Sécuriser les surcharges de modèle.
Mappages de routines de texte générique
Routine TCHAR.H |
_UNICODE & _MBCS non définis |
_MBCS défini |
_UNICODE défini |
---|---|---|---|
_ultot_s |
_ultoa_s |
_ultoa_s |
_ultow_s |
Configuration requise
Routine |
En-tête requis |
---|---|
_ultoa_s |
<stdlib.h> |
_ultow_s |
<stdlib.h> |
Pour plus d'informations sur la compatibilité, consultez Compatibilité dans l'introduction.