_ultoa_s, _ultow_s

Статья
06/09/2015

Преобразовывают 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
Основание системы счисления для value.

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

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

Заметки

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

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

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

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