_ltoa_s, _ltow_s

Artigo
08/25/2010

Converte um inteiro longo em uma seqüência de caracteres.Essas são sistema autônomo versões de _ltoa, _ltow com aprimoramentos de segurança conforme descrito em Aprimoramentos 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 de caracteres resultante.
sizeOfstr
dimensionar do str em bytes _ltoa_s ou palavras para _ltow_s.
radix
Base de value.

Valor de retorno

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

Comentários

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

If str é um NULL ponteiro ou sizeOfstr é menor ou igual a zero, essas funções chamar um manipulador de parâmetro inválido sistema autônomo descrito em Validação de parâmetro. Se a execução for permitida para continuar, essas funções retornam -1 e conjunto errno para EINVAL ou se a value ou str fora do intervalo de um inteiro longo, essas funções retornam -1 e defina o errno para ERANGE.

No C++, usando essas funções é simplificado pelo modelo sobrecargas; sobrecargas de podem inferir o comprimento do buffer automaticamente (eliminando a necessidade de especificar um argumento de dimensionar) e eles podem substituir automaticamente 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érica