_ultoa_s, _ultow_s

Artigo
08/25/2010

Converter um inteiro longo não assinado em uma seqüência de caracteres.Essas são sistema autônomo versões de _ultoa, _ultow com aprimoramentos de segurança conforme descrito em Aprimoramentos de segurança no CRT.

errno_t _ultoa_s(
    unsigned long value,
    char *str,
    size_t sizeOfstr,
    int radix 
);
errno_t _ultow_s(
    unsigned long value,
    wchar_t *str,
    size_t sizeOfstr,
    int radix 
);
template <size_t size>
errno_t _ultoa_s(
    unsigned long value,
    char (&str)[size],
    int radix 
); // C++ only
template <size_t size>
errno_t _ultow_s(
    unsigned long value,
    wchar_t (&str)[size],
    int radix 
); // C++ only

Parâmetros

value
Número a ser convertido.
str
Resultado da seqüência.
sizeOfstr
O dimensionar do str em bytes _ultoa_s ou palavras para _ultow_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 _ultoa_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 (-). _ultow_s é uma versão de caractere largo da _ultoa_s; o segundo argumento do _ultow_s é uma seqüências de caracteres de largura.

If str é um NULL ponteiro, ou se sizeOfstr é menor ou igual a zero, o manipulador de parâmetro inválido é invocado, 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 irão retornar -1 e conjunto 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.For more information, see Proteger overloads de modelo.

Mapeamentos de rotina de texto genérica