_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l

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 im Artikel CRT functions not supported in Universal Windows Platform apps (In Apps für die universelle Windows-Plattform nicht unterstützte CRT-Funktionen).

Syntax

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 wird durch die Einstellung der LC_CTYPE Kategorieeinstellung des Gebietsschemas beeinflusst. 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 _mbctolower wurde sie genannt jtolowerund _mbctoupper wurde aufgerufen jtoupper. Verwenden Sie bei dem neuen Code stattdessen die die neuen Namen.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Informationen zum Ändern dieses Verhaltens finden Sie im Global state in the CRT.

Generische Textroutinzuordnungen

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

Anforderungen

Routinen	Erforderlicher Header
_mbctolower, _mbctolower_l	<mbstring.h>
_mbctoupper, _mbctoupper_l	<mbstring.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Siehe auch

Datenkonvertierung
_mbbtombc, _mbbtombc_l
_mbcjistojms, _mbcjistojms_l, _mbcjmstojis, _mbcjmstojis_l
_mbctohira, _mbctohira_l, _mbctokata, _mbctokata_l
_mbctombb, _mbctombb_l