_ltoa_s, _ltow_s

Статья
06/09/2015

Преобразует целое число типа long в строку. Здесь представлены версии _ltoa, _ltow с усовершенствованной безопасностью, как описано в разделе Функции безопасности в CRT.

errno_t _ltoa_s(
    long value,
    char *str,
    size_t sizeOfstr,
    int radix 
);
errno_t _ltow_s(
    long value,
    wchar_t *str,
    size_t sizeOfstr,
    int radix 
);
template <size_t size>
errno_t _ltoa_s(
    long value,
    char (&str)[size],
    int radix 
); // C++ only
template <size_t size>
errno_t _ltow_s(
    long value,
    wchar_t (&str)[size],
    int radix 
); // C++ only

Параметры

value
Число, которое нужно преобразовать.
str
Буфер для результирующей строки.
sizeOfstr
Размер str в байтах для _ltoa_s или словах для _ltow_s.
radix
Основание системы счисления для value.

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

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

Заметки

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

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

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

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