_ltoa, _ltow

Artigo
06/09/2015

Converte um inteiro longo para uma cadeia de caracteres. Versões mais seguras dessas funções estão disponíveis; consulte _ltoa_s, _ltow_s.

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

Parâmetros

value
Número a ser convertido.
str
Resultado da cadeia de caracteres.
radix
Base de value.

Valor de retorno

Cada uma dessas funções retorna um ponteiro para str. Não há nenhum retorno de erro.

Comentários

A função de _ltoa converte os dígitos de value a uma cadeia de caracteres com terminação nula e armazena o resultado (até 33 bytes) em str. O argumento de radix especifica a base de value, que deve estar no intervalo de 2 a 36. Se radix é igual a 10 e value for negativo, o primeiro caractere da cadeia de caracteres é armazenada o sinal de menos (–). _ltow é uma versão de ampla caractere de _ltoa; o segundo argumento e valor de retorno de _ltow são cadeias de caracteres de ampla caractere. Cada uma dessas funções são microsoft específica.

Observação de segurança
Para impedir excesso de buffer, verifique se o buffer de str seja grande o suficiente para manter os dígitos convertidos mais com o caractere à direita e um caractere de sinal.