_ltoa, _ltow

Статья
06/09/2015

Преобразует целое число типа long в строку. Существуют более безопасные версии этих функций; см. раздел _ltoa_s, _ltow_s.

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

Параметры

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

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

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

Заметки

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

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