Compartilhar via


_ltoa_s, _ltow_s

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

Rotina tchar.h

_UNICODE e _MBCS não definido

_MBCS definido

_UNICODE definido

_ltot_s

_ltoa_s

_ltoa_s

_ltow_s

Requisitos

Rotina

Cabeçalho necessário

_ltoa_s

<stdlib.h>

_ltow_s

<stdlib.h>

Para obter mais informações de compatibilidade, consulte Compatibilidade na introdução.

Equivalente do NET Framework

sistema::converter::ToString

Consulte também

Referência

Conversão de Dados

_itoa, _i64toa, _ui64toa, _itow, _i64tow, _ui64tow

_ultoa, _ultow

_ultoa_s, _ultow_s