_ultoa, _ultow

Статья
06/09/2015

Преобразовывают unsigned long integer в строку. Существуют более безопасные версии этих функций; см. раздел _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

Параметры

value
Число, которое нужно преобразовать.
str
Строковый результат.
radix
Основание системы счисления для value*.*

Возвращаемое значение

Каждая из этих функций возвращает указатель на str. Нет какого-либо возврата ошибки.

Заметки

Функция _ultoa преобразует value в символьную строку, завершающуюся символом null, и сохраняет результат (до 33 байт) в str. Проверка на переполнение не выполняется. radix определяет основание системы счисления value; radix должно находиться в диапазоне от 2 до 36. _ultow — это версия _ultoa для расширенных символов.

Примечание по безопасности
Чтобы предотвратить переполнение буфера, убедитесь, что буфер str достаточно велик для хранения преобразованных цифр, а также конечного символа null.

В C++ эти функции имеют шаблонные перегрузки, которые вызывают более новые и безопасные аналоги этих функций. Дополнительные сведения см. в разделе Безопасные перегрузки шаблонов.

Универсальное текстовое сопоставление функций

Подпрограмма TCHAR.H	_UNICODE & _MBCS не определены	_MBCS определено	_UNICODE определено
_ultot	_ultoa	_ultoa	_ultow

Требования

Подпрограмма	Обязательный заголовок
_ultoa	<stdlib.h>
_ultow	<stdlib.h> или <wchar.h>

Дополнительные сведения о совместимости см. в разделе Совместимость во введении.

Пример

См. пример для _itoa.

Эквивалент в .NET Framework

System::Convert::ToString

См. также

Ссылки

Преобразование данных

_itoa, _i64toa, _ui64toa, _itow, _i64tow, _ui64tow

Поделиться через