_ltoa, _ltow
The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.
The latest version of this topic can be found at _ltoa, _ltow.
Converts a long integer to a string. More secure versions of these functions 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.
Each of these functions returns a pointer to str. There is no error return.
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.
To prevent buffer overruns, ensure that the |
In C++, these functions have template overloads. For more information, see Secure Template Overloads.
Generic-Text Routine Mappings
| Tchar.h routine | _UNICODE and _MBCS not defined | _MBCS defined | _UNICODE defined |
|---|---|---|---|
_ltot | _ltoa | _ltoa | _ltow |
| Routine | Required header |
|---|---|
_ltoa | <stdlib.h> |
_ltow | <stdlib.h> |
For more compatibility information, see Compatibility in the Introduction.
See the example for _itoa.
Data Conversion
_itoa, _i64toa, _ui64toa, _itow, _i64tow, _ui64tow
_ultoa, _ultow