_ltoa, _ltow
Converts a long integer to a string. These functions are deprecated because more secure versions are available; see _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
Parameters
- value
-
Number to be converted.
- str
-
String result.
- radix
-
Base of value.
The _ltoa function converts the digits of value to a null-terminated character string and stores the result (up to 33 bytes) in str. The radix argument specifies the base of value, which must be in the range 2 – 36. If radix equals 10 and value is negative, the first character of the stored string is the minus sign (–). _ltow is a wide-character version of _ltoa; the second argument and return value of _ltow are wide-character strings. Each of these functions is Microsoft-specific.
Security Note |
|---|
| To prevent buffer overruns, ensure that the str buffer is large enough to hold the converted digits plus the trailing null-character and a sign character. |
In C++, these functions have template overloads. For more information, see Secure Template Overloads.
| Tchar.h routine | _UNICODE and _MBCS not defined | _MBCS defined | _UNICODE defined |
|---|---|---|---|
| _ltot | _ltoa | _ltoa | _ltow |
| Routine | Required header | Compatibility |
|---|---|---|
| _ltoa | <stdlib.h> | Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 |
| _ltow | <stdlib.h> | Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 |
For more compatibility information, see Compatibility in the Introduction.
Security Note