_ultoa_s, _ultow_s

Статья
02/20/2013

Преобразование unsigned long integer в строку.Эти версии _ultoa, _ultow со службами расширений безопасности, как описано в разделе Средства безопасности в 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

Параметры

value
Число для преобразования.
str
Строковый результат.
sizeOfstr
Размер str в байтах для _ultoa_s или машинные слова для _ultow_s.
radix
Base value.

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

Нуль, если функция была успешно или коды ошибки.

Заметки

_ultoa_s функция преобразует числа value в null-завершенной символьную строку и хранит результат (33 байта) str.radix аргумент указывает основание value, который должен быть в диапазоне от 2 до 36._ultow_s версия расширенных символов _ultoa_s; второй аргумент _ultow_s широкие символьной строки.

If str a NULL указатель или sizeOfstr меньше или равно нулю, недопустимый параметр вызван обработчик, как описано в разделе Проверка параметров.Если выполнение может быть продолжено, то эти функции возвращают -1 и задают errno В EINVALили value OR str за пределы диапазона длинного целого числа, эти функции возвращают -1 и установят errno В ERANGE.

В C++ с помощью этих функций упрощает перегрузками шаблона; перегруженные методы могут определять длина буфера, автоматически (что устраняет необходимость указать аргумент size) и они могут автоматически заменять старые, non-безопасные функции с их новыми, безопасный копиями.Дополнительные сведения см. в разделе Предоставляйте перегруженный шаблона.

Сопоставления подпрограммы Родов-Текста