_mbctolower, _mbctoupper
Visual Studio .NET 2003
Test and convert the case of a multibyte character.
unsigned int _mbctolower( unsigned int c ); unsigned int _mbctoupper( unsigned int c );
Parameter
- c
- Multibyte character to convert.
Return Value
Each of these functions returns the converted character c, if possible. Otherwise it returns the character c unchanged.
Remarks
The _mbctolower and _mbctoupper functions test a character c and, if possible, apply one of the following conversions.
| Routine | Converts |
|---|---|
| _mbctolower | Uppercase character to lowercase character |
| _mbctoupper | Lowercase character to uppercase character |
In previous versions, _mbctolower was called jtolower, and _mbctoupper was called jtoupper. For new code, use the new names instead.
Generic-Text Routine Mappings
| TCHAR.H routine | _UNICODE & _MBCS not defined | _MBCS defined | _UNICODE defined |
|---|---|---|---|
| _totlower | tolower | _mbctolower | towlower |
| _totupper | toupper | _mbctoupper | towupper |
Requirements
| Routine | Required header | Compatibility |
|---|---|---|
| _mbctolower | <mbstring.h> | Win 98, Win Me, Win NT, Win 2000, Win XP |
| _mbctoupper | <mbstring.h> | Win 98, Win Me, Win NT, Win 2000, Win XP |
For additional compatibility information, see Compatibility in the Introduction.
Libraries
All versions of the C run-time libraries.
See Also
Data Conversion Routines | _mbbtombc | _mbcjistojms | _mbctohira | _mbctombb | Run-Time Routines and .NET Framework Equivalents
