_ltoa_s, _ltow_s

Artigo
02/25/2013

Converte um inteiro longo em uma seqüência de caracteres.Estas são as versões do _ltoa, _ltow com aprimoramentos de segurança, conforme 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 para a seqüência resultante.
sizeOfstr
Tamanho da str em bytes para _ltoa_s ou palavras para _ltow_s.
radix
Base of value.

Valor de retorno

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

Comentários

O _ltoa_s função converte os dígitos do value como uma seqüência terminada por caractere nulo e armazena o resultado (até 33 bytes) em str.O radix argumento especifica a base de value, que deve estar no intervalo de 2 – 36.Se radix é igual a 10 e value é negativo, o primeiro caractere da seqüência de caracteres armazenado é o sinal de menos (-)._ltow_sé uma versão de caractere largo de _ltoa_s; o segundo argumento do _ltow_s é uma seqüências de caracteres de largura.

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

No C++, a utilização dessas funções é simplificado pela sobrecargas do modelo; os métodos sobrecarregados podem inferir o comprimento do buffer automaticamente (eliminando a necessidade de especificar um argumento de tamanho) e eles podem substituir automaticamente os funções não seguras, mais antigas, com suas contrapartes mais recentes e seguras.Para obter mais informações, consulte Proteger Overloads de modelo.

Mapeamentos de rotina de texto genérico