_ltoa_s, _ltow_s

Artigo
06/09/2015

Converte um inteiro longo para uma cadeia de caracteres. Essas são as versões de _ltoa, _ltow com aprimoramentos de segurança, como descrito em Recursos de segurança no 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

Parâmetros

value
Número a ser convertido.
str
Buffer da cadeia de caracteres resultante.
sizeOfstr
Tamanho de str em bytes para _ltoa_s ou no word para _ltow_s.
radix
Base de value.

Valor de retorno

Nulo se a função foi bem-sucedida ou um código de erro.

Comentários

A função de _ltoa_s 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_s é uma versão ampla de caracteres de _ltoa_s; o segundo argumento de _ltow_s é cadeias de caracteres amplas.

Se str é um ponteiro de NULL ou sizeOfstr é menor ou igual a zero, essas funções invoca um manipulador inválido do parâmetro, conforme descrito em Validação do parâmetro. Se a execução for permitida continuar, essas funções retornam -1 e errno definido como EINVAL ou se value ou str fora do intervalo de um inteiro longo, essas funções retornam A-1 e definem errno a ERANGE.

No C++, o uso dessas funções é simplificado por sobrecargas de modelo; as sobrecargas podem interpretar o tamanho do buffer automaticamente (eliminando a necessidade de especificar um argumento de tamanho) e podem substituir automaticamente as funções menos seguras mais antigas por correspondentes mais seguras e mais recentes. Para obter mais informações, consulte Sobrecargas de modelo seguras.

Mapeamentos da rotina de texto genérico