_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l

Artikel
06/09/2015

Testet und konvertiert den Groß-/Kleinbuchstaben eines Multibytezeichen.

Wichtig

Diese API kann nicht in Anwendungen verwendet werden, die in Windows-Runtime ausgeführt werden.Weitere Informationen finden Sie unter CRT-Funktionen nicht mit /ZW unterstützt.

unsigned int _mbctolower(
   unsigned int c 
);
unsigned int _mbctolower_l(
   unsigned int c,
   _locale_t locale
);
unsigned int _mbctoupper(
   unsigned int c 
);
unsigned int _mbctoupper_l(
   unsigned int c,
   _locale_t locale
);

Parameter

c
Zu konvertierendes Multibytezeichen.
locale
Zu verwendendes Gebietsschema.

Rückgabewert

Jede dieser Funktionen gibt das konvertierte Zeichen c zurück, sofern dies möglich ist. Andernfalls wird das Zeichen c unverändert zurückgegeben.

Hinweise

Die Funktionen testen ein Zeichen c und geben, falls möglich, eine der folgenden Konvertierungen zurück.

Routinen	Konvertiert
_mbctolower,_mbctolower_l	Großbuchstaben in Kleinbuchstaben.
_mbctoupper,_mbctoupper_l	Kleinbuchstaben in Großbuchstaben.

Der Ausgabewert ist von der LC_CTYPE-Kategorieneinstellung des Gebietsschemas betroffen; weitere Informationen finden Sie unter setlocale. Die Version dieser Funktion ohne das _l-Suffix verwendet das aktuelle Gebietsschema für dieses vom Gebietsschema abhängige Verhalten; die Version mit dem _l-Suffix ist beinahe identisch, verwendet jedoch stattdessen den ihr übergebenen Gebietsschemaparameter. Weitere Informationen finden Sie unter Locale.

In früheren Versionen wurde _mbctolower als jtolower und _mbctoupper als jtoupper bezeichnet. Verwenden Sie bei dem neuen Code stattdessen die die neuen Namen.

Zuordnung generischer Textroutinen

Tchar.h-Routine	_UNICODE und _MBCS nicht definiert	_MBCS definiert	_UNICODE definiert
_totlower	tolower	_mbctolower	towlower
_totlower_l	_tolower_l	_mbctolower_l	_towlower_t
_totupper	toupper	_mbctoupper	towupper
_totupper_l	toupper_l	_mbctoupper_l	_towupper_l