_ultoa_s, _ultow_s

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

Convertir un entier long non signé en une chaîne. Voici les versions de _ultoa, _ultow avec des améliorations de sécurité comme décrit dans fonctionnalités de sécurité de la bibliothèque 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 à convertir.

str
Chaîne de résultat.

sizeOfstr
La taille de la str en octets pour _ultoa_s ou mots pour _ultow_s.

radix
Base de value.

Zéro si la fonction a réussi ou un code d’erreur.

Le _ultoa_s fonction convertit les chiffres de value à une chaîne de caractères se terminant par null et stocke le résultat (près de 33 octets) dans str. Le radix argument spécifie la base de value, qui doit être comprise entre 2 à 36. _ultow_sest une version à caractère élargi de _ultoa_s; le deuxième argument de _ultow_s est des chaînes de caractères larges.

Si str est un NULL pointeur, 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’exécution est autorisée à se poursuivre, ces fonctions retournent -1 et errno à EINVAL ou si le value ou str hors des limites d’un entier long, ces fonctions retournera une valeur -1 et affectez le errno à 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 Secure Template Overloads.

Mappages de routines de texte générique

Routine TCHAR.H_UNICODE et _MBCS non définis_MBCS défini_UNICODE défini
_ultot_s_ultoa_s_ultoa_s_ultow_s
RoutineEn-tête requis
_ultoa_s<stdlib.h>
_ultow_s<stdlib.h>

Pour plus d'informations sur la compatibilité, voir Compatibilité dans l'introduction.

System::Convert::ToString

Conversion de données
_ultoa, _ultow
_ltoa, _ltow
_ltoa_s, _ltow_s
_ltoa_s, _ltow_s

Afficher: