Partilhar via


_ultoa, _ultow

Converta um inteiro longo não assinado em uma seqüência de caracteres.Versões mais seguras dessas funções estão disponíveis; see _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
    Seqüência de resultado.

  • radix
    Base of value*.*

Valor de retorno

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

Comentários

O _ultoa função converte value como uma seqüência terminada por caractere nulo e armazena o resultado (até 33 bytes) em str.Nenhuma verificação de estouro será executada.radixEspecifica a base de value; radixdeve estar no intervalo de 2 – 36._ultowé uma versão de caractere largo de _ultoa.

Observação de segurançaObservação de segurança

Para evitar saturações de buffer, assegurar que o str o buffer é grande o suficiente para manter os dígitos convertidos mais o caractere null à direita.

No C++, essas funções têm sobrecargas de modelo que invocam as suas similares do mais recentes, seguras dessas funções.Para obter mais informações, consulte Proteger Overloads de modelo.

Mapeamentos de rotina de texto genérico

TCHAR.Rotina H

_ Unicode & _ MBCS do arquivo não definido

_ MBCS do arquivo 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 de compatibilidade, consulte compatibilidade na introdução.

Exemplo

Consulte o exemplo para _itoa.

Equivalência do .NET Framework

System::CONVERT::ToString

Consulte também

Referência

Conversão de Dados

_itoa, _i64toa, _ui64toa, _itow, _i64tow, _ui64tow