_ultoa, _ultow
Convertit un entier long non signé en une chaîne. Des versions plus sécurisées de ces fonctions sont disponibles ; consultez _ultoa_s, _ultow_s.
char *_ultoa(
unsigned long value,
char *str,
int radix
);
wchar_t *_ultow(
unsigned long value,
wchar_t *str,
int radix
);
template <size_t size>
char *_ultoa(
unsigned long value,
char (&str)[size],
int radix
); // C++ only
template <size_t size>
wchar_t *_ultow(
unsigned long value,
wchar_t (&str)[size],
int radix
); // C++ only
Paramètres
value
Nombre devant être converti.str
Chaîne de résultat.radix
Base de value*.*
Valeur de retour
Chacune de ces fonctions renvoie un pointeur vers str. Aucun retour d'erreur.
Notes
La fonction _ultoa convertit value en chaîne de caractères se terminant par null et stocke le résultat (jusqu'à 33 octets) dans str. Aucune vérification des dépassements n'est effectuée. radix spécifie la base de value; radix doit être comprise entre 2 et 36. _ultow est une version à caractère élargi de _ultoa.
.gif "Note de sécurité") Note de sécurité |
|---|
Pour empêcher les dépassements de mémoire tampon, assurez-vous que la mémoire tampon de str est suffisamment grande pour contenir les chiffres convertis plus le caractère Null de fin. |
En C++, ces fonctions ont des surcharges de modèle qui appellent les équivalents plus récents et sécurisés de ces fonctions. 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 |
_ultoa |
_ultoa |
_ultow |
Configuration requise
Routine |
En-tête requis |
|---|---|
_ultoa |
<stdlib.h> |
_ultow |
<stdlib.h> ou <wchar.h> |
Pour plus d'informations sur la compatibilité, consultez Compatibilité dans l'introduction.
Exemple
Consultez l'exemple de _itoa.