_ultoa_s, _ultow_s

Artigo
02/25/2013

Converta um inteiro longo não assinado em uma seqüência de caracteres.Estas são as versões do _ultoa, _ultow com aprimoramentos de segurança, conforme descrito em Recursos 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
Seqüência de resultado.
sizeOfstr
O tamanho da str em bytes para _ultoa_s ou palavras para _ultow_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 _ultoa_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._ultow_sé uma versão de caractere largo de _ultoa_s; o segundo argumento do _ultow_s é uma seqüências de caracteres de largura.

Se str é um NULL ponteiro, ou se sizeOfstr é menor ou igual a zero, o manipulador de parâmetro inválido é invocado, 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 retornar -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