_ultoa, _ultow
Converter um inteiro longo não assinado em uma seqüência de caracteres.Versões mais seguras dessas funções estão disponível; 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 seqüência.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
The _ultoa função converte value a uma seqüência de caracteres terminada com caractere nulo e armazena o resultado (até 33 bytes) em str. Nenhuma verificação de estouro será executada.radix Especifica a base do value; radix deve estar no intervalo de 36 – 2. _ultow é uma versão de caractere largo da _ultoa.
.gif "Observação de segurança") Observação de segurança: |
|---|
Para evitar saturações de buffer, certifique-se de que o str buffer é grande o suficiente para manter os dígitos convertidos mais o caractere nulo à direita. |
No C++, essas funções têm sobrecargas de modelo que invocam as suas similares do mais recentes, seguras dessas funções.For more information, see Proteger overloads de modelo.
Mapeamentos de rotina de texto genérica
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 obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.
Exemplo
Consulte o exemplo para _itoa.