Partager via


_ltoa_s, _ltow_s

Convertit un entier long en chaine. Il s'agit de versions de _ltoa, _ltow avec des améliorations de sécurité, comme décrit dans Fonctionnalités de sécurité dans le CRT.

errno_t _ltoa_s(
    long value,
    char *str,
    size_t sizeOfstr,
    int radix 
);
errno_t _ltow_s(
    long value,
    wchar_t *str,
    size_t sizeOfstr,
    int radix 
);
template <size_t size>
errno_t _ltoa_s(
    long value,
    char (&str)[size],
    int radix 
); // C++ only
template <size_t size>
errno_t _ltow_s(
    long value,
    wchar_t (&str)[size],
    int radix 
); // C++ only

Paramètres

  • value
    Nombre devant être converti.

  • str
    Mémoire tampon de la chaîne résultante.

  • sizeOfstr
    Taille destr en octets pour _ltoa_s ou les mots de _ltow_s.

  • radix
    Base de value.

Valeur de retour

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

Notes

La fonction _ltoa_s convertit les chiffres devalue 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. Si radix est égal à 10 et que value est négative, le premier caractère de la chaîne stockée est le signe moins (-). _ltow_s est une version à caractères larges de _ltoa_s ; le deuxième argument de _ltow_s est une chaine à caractères larges.

Si str est un pointeur NULL ou quesizeOfstr est inférieure ou égale à zéro, elles appellent un gestionnaire de paramètre non valide, 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 et _MBCS non définis

_MBCS défini

_UNICODE défini

_ltot_s

_ltoa_s

_ltoa_s

_ltow_s

Configuration requise

Routine

En-tête requis

_ltoa_s

<stdlib.h>

_ltow_s

<stdlib.h>

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

Équivalent .NET Framework

System::Convert::ToString

Voir aussi

Référence

Conversion de données

_itoa, _i64toa, _ui64toa, _itow, _i64tow, _ui64tow

_ultoa, _ultow

_ultoa_s, _ultow_s