toupper, _toupper, towupper, _toupper_l, _towupper_l
For the latest documentation on Visual Studio 2017, see Visual Studio 2017 Documentation.
Convert character to uppercase.
int toupper( int c ); int _toupper( int c ); int towupper( wint_t c ); int _toupper_l( int c , _locale_t locale ); int _towupper_l( wint_t c , _locale_t locale );
Character to convert.
Locale to use.
Each of these routines converts a copy of
c, if possible, and returns the result.
c is a wide character for which
iswlower is nonzero and there is a corresponding wide character for which
iswupper is nonzero,
towupper returns the corresponding wide character; otherwise,
There is no return value reserved to indicate an error.
Each of these routines converts a given lowercase letter to an uppercase letter if possible and appropriate. The case conversion of
towupper is locale-specific. Only the characters relevant to the current locale are changed in case. The functions without the
_l suffix use the currently set locale. The versions of these functions with the
_l suffix take the locale as a parameter and use that instead of the currently set locale. For more information, see Locale.
|TCHAR.H routine||_UNICODE & _MBCS not defined||_MBCS defined||_UNICODE defined|
|<ctype.h> or <wchar.h>|
For additional compatibility information, see Compatibility in the Introduction.
See the example in to Functions.