CharUpperBuffA 函式 (winuser.h)

將緩衝區中的小寫字元轉換為大寫字元。函式會就地轉換字元。

語法

DWORD CharUpperBuffA(
  [in, out] LPSTR lpsz,
  [in]      DWORD cchLength
);

[in, out] lpsz

類型： LPTSTR

包含要處理的一或多個字元的緩衝區。

[in] cchLength

類型： DWORD

lpsz所指向之緩衝區的大小，以字元為單位。

函式會檢查每個字元，並將小寫字元轉換成大寫字元。函式會檢查 cchLength所指示的字元數，即使一或多個字元是 Null 字元也一樣。

類型： DWORD

傳回值是已處理的字元數。

例如，如果 CharUpperBuff (「API 集的 Zenith」，則 10) 成功，則傳回值為 10。

請注意， CharUpperBuff 一律會將小寫 I (「i」) 對應到大寫 I，即使目前的語言是土耳其文或亞塞亞塞亞文也一樣。如果您需要在此方面具有語言敏感性的函式，請呼叫 LCMapString。

在 ANSI 版本的函式中轉換為 Unicode，在所有情況下，都會使用系統預設地區設定來完成。

注意

winuser.h 標頭會將 CharUpperBuff 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。