Partager via


_ultoa_s, _ultow_s

Convertissez un long entier non signé dans une chaîne.Ce sont des versions de _ultoa, _ultow avec des améliorations de sécurité comme décrit dans Fonctionnalités de sécurité du 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
    résultat de chaîne.

  • sizeOfstr
    la taille d' str en octets pour _ultoa_s ou des mots pour _ultow_s.

  • radix
    base d' value.

Valeur de retour

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

Notes

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

si str est un pointeur d' 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 des paramètres.Si est autorisé à l'exécution de se poursuivre, ces fonctions retournent -1 et errno défini à EINVALou si value ou str hors limites d'un long entier, ces fonctions retournera une valeur et définit errno à ERANGE.

En C++, à l'aide de ces fonctions est simplifié par des surcharges de modèle ; les surcharges peuvent également déduire la longueur de la mémoire tampon automatiquement (en éliminant le besoin de spécifier un argument de taille) et peuvent remplacer automatiquement des fonctions plus anciennes et non sécurisées par leurs nouvelles, sécurisées équivalents.Pour plus d'informations, consultez Surcharges sécurisées de modèle.

mappages de routines de texte générique

routine de TCHAR.H

_MBCS & de _UNICODE non défini

_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 des informations de compatibilité supplémentaires, consultez compatibilité dans l'introduction.

Équivalent .NET Framework

System : : Conversion : : ToString

Voir aussi

Référence

Conversion de données

_ultoa, _ultow

_ltoa, _ltow

_ltoa_s, _ltow_s

_ltoa_s, _ltow_s