_ultoa_s, _ultow_s

Artigo
06/09/2015

Converter um inteiro longo não assinado para uma cadeia de caracteres. Essas são as versões de _ultoa, _ultow com aprimoramentos de segurança, como 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
Resultado da cadeia de caracteres.
sizeOfstr
O tamanho de str em bytes para _ultoa_s ou no word para _ultow_s.
radix
Base de value.

Valor de retorno

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

Comentários

A função de _ultoa_s converte os dígitos de value a uma cadeia de caracteres com terminação nula e armazena o resultado (até 33 bytes) em str. O argumento de radix especifica a base de value, que deve estar no intervalo de 2 a 36. _ultow_s é uma versão ampla de caracteres de _ultoa_s; o segundo argumento de _ultow_s é cadeias de caracteres amplas.

Se str é um ponteiro de NULL , ou se sizeOfstr é menor ou igual a zero, o manipulador inválido do parâmetro será chamado, conforme descrito em Validação do parâmetro. Se a execução for permitida continuar, essas funções retornam -1 e errno definido como EINVAL ou se value ou str fora do intervalo de um inteiro longo, essas funções retornarão A-1 e definirá errno a ERANGE.

No C++, o uso dessas funções é simplificado por sobrecargas de modelo; as sobrecargas podem interpretar o tamanho do buffer automaticamente (eliminando a necessidade de especificar um argumento de tamanho) e podem substituir automaticamente as funções menos seguras mais antigas por correspondentes mais seguras e mais recentes. Para obter mais informações, consulte Sobrecargas de modelo seguras.

Mapeamentos da rotina de texto genérico