CharNextW 函式 (winuser.h)

擷取字串中下一個字元的指標。 此函式可以處理由單一或多位元組位元組成的字串。

語法

LPWSTR CharNextW(
  [in] LPCWSTR lpsz
);

參數

[in] lpsz

類型： LPCTSTR

以 Null 結尾的字串中的字元。

傳回值

類型： LPTSTR

傳回值是字串中下一個字元的指標，如果位於字元串結尾，則為終止 Null 字元。

如果 lpsz 指向終止 Null 字元，則傳回值等於 lpsz。

備註

當呼叫為 ANSI 函式時， CharNext 會使用系統預設代碼頁，而 CharNextExA 則會指定要使用的代碼頁。

此函式適用於處理讀音符號時，字元的預設「使用者」期望。 例如：包含 U+0061 U+030a “LATIN SMALL LETTER A” + COMBINING RING ABOVE“ 的字串，看起來像 ”å“，將會前進兩個字碼點，而不是一個。 包含 U+0061 U+0301 U+0302 U+0303 U+0304 的字串，看起來像 “a'^~ ^~”，將會前進五個字碼點，而不是一個，依此類移。

注意

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

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
Dll	User32.dll

另請參閱

CharNextExA

CharPrev

概念

參考

字串