_ltoa_s, _ltow_s

Статья
02/20/2013

Преобразовывает заданное длинное целое число в строку.эти версии _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
Base value.

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

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

Заметки

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

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

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

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