_mbctolower、_mbctolower_l、_mbctoupper、_mbctoupper_l

發行項
06/09/2015

測試和轉換多位元組字元的大小寫。

重要

這個應用程式開發介面不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 /ZW 不支援 CRT 函式。

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
);

參數

c
要轉換的多位元組字元。
locale
要使用的地區設定。

傳回值

若轉換成功，這些函式會傳回轉換的字元 c。否則會傳回未改變的字元 c。

備註

這些函式測試字元 c ，並且，可能的話，會套用下列其中一個轉換。

常式	轉換
_mbctolower,_mbctolower_l	大寫字元轉換為小寫字元。
_mbctoupper,_mbctoupper_l	小寫字元轉換為大寫字元。

輸出值受地區設定的LC_CTYPE 分類設定所影響。如需詳細資訊，請參閱 setlocale 。沒有 _l 後綴的函式版本在這些地區相依的行為上使用目前的地區設定，而有 _l 後綴的函式版本也是相同的，除了它們會使用傳入的地區設定參數之外。如需詳細資訊，請參閱地區設定。

在舊版中， _mbctolower 稱為 jtolower，且 _mbctoupper 稱為 jtoupper。如果是新的程式碼，請使用新的名稱。

一般文字常式對應

Tchar.h 常式	未定義 _UNICODE and _MBCS	已定義 _MBCS	已定義 _UNICODE
_totlower	tolower	_mbctolower	towlower
_totlower_l	_tolower_l	_mbctolower_l	_towlower_t
_totupper	toupper	_mbctoupper	towupper
_totupper_l	toupper_l	_mbctoupper_l	_towupper_l