_ultoa, _ultow

Artigo
06/09/2015

Converter um inteiro longo não assinado para uma cadeia de caracteres. Versões mais seguras dessas funções estão disponíveis; consulte _ultoa_s, _ultow_s.

char *_ultoa(
   unsigned long value,
   char *str,
   int radix 
);
wchar_t *_ultow(
   unsigned long value,
   wchar_t *str,
   int radix 
);
template <size_t size>
char *_ultoa(
   unsigned long value,
   char (&str)[size],
   int radix 
); // C++ only
template <size_t size>
wchar_t *_ultow(
   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.
radix
Base de value*.*

Valor de retorno

Cada uma dessas funções retorna um ponteiro para str. Não há nenhum retorno de erro.

Comentários

A função de _ultoa converte value a uma cadeia de caracteres com terminação nula e armazena o resultado (até 33 bytes) em str. Nenhuma verificação de estouro será executado. radix especifica a base de value; radix deve estar no intervalo de 2 a 36. _ultow é uma versão de caracteres largos de _ultoa.

Observação de segurança
Para impedir excesso de buffer, verifique se o buffer de str seja grande o suficiente para manter os dígitos convertidos mais com o caractere à direita.

No C++, essas funções têm as sobrecargas de modelo que invocam as correspondentes seguras mais recentes dessas funções. Para obter mais informações, consulte Sobrecargas de modelo seguras.

Mapeamentos da rotina de texto genérico

Rotina TCHAR.H	_UNICODE & _MBCS não definido	_MBCS definido	_UNICODE definido
_ultot	_ultoa	_ultoa	_ultow

Requisitos

Rotina	Cabeçalho necessário
_ultoa	<stdlib.h>
_ultow	<stdlib.h> ou <wchar.h>

Para informações adicionais de compatibilidade, consulte Compatibilidade na Introdução.

Exemplo

Consulte o exemplo de _itoa.

Equivalência do .NET Framework

System::Convert::ToString

Consulte também

Referência

Conversão de dados

_itoa, _i64toa, _ui64toa, _itow, _i64tow, _ui64tow

Partilhar via