Locale-Sensitive C/C++ String Operation Function

char *_strupr(char* str);

unsigned char *_mbsupr(unsigned char* str);

wchar_t *_wcsupr(wchar_t* str);

_TXCHAR *_tcsupr(const _TXCHAR* str);

Internationalization (I18n) Function Overview

The _strupr function converts any lowercase characters in str to uppercase letters, using the LC_CTYPE category setting of the current locale, and returns a pointer to the converted string.

_mbsupr and _wcsupr are the multibyte and wide versions of _strupr. The argument and return value of _mbsupr are multibyte-character strings; those of _wcsupr are wide-character strings.

_tcsupr is the Windows-only Generic version of the function; with the _MBCS or _UNICODE compiler flags determining its mapping to either _mbsupr or _wcsupr.

I18n Issues

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

Ensure that the current locale is set properly.

Consider using the more secure versions of these functions, _strupr_s, _wcsupr_s, _tcsupr_s, if available.

Recommended Replacements*

Microsoft Windows MBCS	_mbsupr
Microsoft Windows Unicode	_wcsupr
Microsoft Windows Generic	_tcsupr

Locale-Sensitive C/C++ String Operation Functions