_ltoa_s, _ltow_s

Article
03/04/2013

Convertit un entier long en chaîne.Ce sont des versions de _ltoa, _ltow avec des améliorations de sécurité comme décrit dans Fonctionnalités de sécurité du 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 à convertir.
str
Mémoire tampon pour la chaîne résultante.
sizeOfstr
taille d' str en octets pour _ltoa_s ou des mots pour _ltow_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' _ltoa_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.Si radix égal à 10 et value est négatif, le premier caractère de la chaîne stockée est le signe moins (-)._ltow_s est une version à caractère élargi d' _ltoa_s; le deuxième argument d' _ltow_s est des chaînes à caractères larges.

si str est un pointeur d' NULL ou sizeOfstr est inférieur ou égal à zéro, ces fonctions appellent un gestionnaire de paramètre non valide, 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 retournent une valeur et définissent 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