String Format Function

int _vscprintf(const char *format, va_list argptr);

int _vscwprintf(const wchar_t *format, va_list argptr);

int _vsctprintf(const TCHAR *format, va_list argptr);

Internationalization (I18n) Function Overview

The _vscprintf function returns the number of characters that the specified format argument and the data pointed to by the argptr argument would output. The value returned does not include the null character.

_vscwprintf is the wide character version and returns the number of wide characters written.

_vsctprintf is the Windows-only Generic version of the function; with the _MBCS or _UNICODE compiler flags determining its mapping to either _vscprintf or _vscwprintf.

I18n Issues

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

Prior to calling one of these functions, ensure that the current locale is set properly by calling setlocale, as string formatting is dependent on the LC_NUMERIC locale category. See String Formatting in C and C++ for a discussion on locale-sensitive formatting in internationalized applications.

Recommended Replacements*

Microsoft Windows MBCS	_vscprintf
Microsoft Windows Unicode	_vscwprintf
Microsoft Windows Generic	_vsctprintf

String Format Functions