Character Manipulation Function

char* _i64toa(__int64 value, char* str, int radix);

wchar_t* _i64tow(__int64 value, wchar_t* str, int radix);

TCHAR* _i64tot(__int64 value, TCHAR* str, int radix);

Internationalization (I18n) Function Overview

The _i64toa function converts the digits in value to a null-terminated character string and stores the result (up to 65 single-byte characters) in str. No overflow checking is performed, and the return is a pointer to str. radix specifies the base of value and 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 (-).

_i64tow is the wide-character version of _itoa, storing up to 65 wide characters.

_i64tot is the Windows-only Generic version of the function; with the _MBCS or _UNICODE compiler flags determining its mapping to either _i64toa or _i64tow.

I18n Issues

Use the appropriate version of the function as required for internationalization support, noting the following:

These functions are not locale-dependent and should not be used for negative decimal values, which enforces the placement and symbol of the negative sign, rather than relying on the settings of the user's current locale. Instead, use one of the sprintf functions.

In addition, consider using the more secure versions, _i64toa_s, _i64tow_s, _i64tot_s, if available.

Recommended Replacements*

Microsoft Windows MBCS	_i64toa
Microsoft Windows Unicode	_i64tow
Microsoft Windows Generic	_i64tot

Character Manipulation Functions