_mbctolower, , _mbctolower_l_mbctoupper_mbctoupper_l

  • Artikel

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. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Mapping 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

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