字串

本節說明字串函式，並說明如何在應用程式中使用這些函式。

本節內容

名稱	描述
關於字串	討論字串函式。
關於 Strsafe.h	討論 Strsafe.h 中的字串函式。
字串參考	包含 API 參考。

字串函式

名稱	描述
CharLower	將字元字串或單一字元轉換成小寫。 如果運算元是字元字串，函式就會就地轉換字元。
CharLowerBuff	將緩衝區中的大寫字元轉換為小寫字元。 函式會就地轉換字元。
CharNext	擷取字串中下一個字元的指標。 此函式可以處理由單一或多位元組字元組成的字串。
CharNextExA	擷取字串中下一個字元的指標。 此函式可以處理由單一或多位元組字元組成的字串。
CharPrev	擷取字串中前一個字元的指標。 此函式可以處理由單一或多位元組字元組成的字串。
CharPrevExA	擷取字串中前一個字元的指標。 此函式可以處理由單一或多位元組字元組成的字串。
CharToOem	將字串轉譯成 OEM 定義的字元集。
CharToOemBuff	將字串中的指定字元數轉譯成 OEM 定義的字元集。
CharUpper	將字元字串或單一字元轉換成大寫。 如果運算元是字元字串，函式就會就地轉換字元。
CharUpperBuff	將緩衝區中的小寫字元轉換為大寫字元。 函式會就地轉換字元。
CompareString	使用指定的地區設定來比較兩個字元字串。 注意： 若要與 Unicode 相容，請使用 CompareStringEx 或 CompareString的 Unicode 版本。
CompareStringEx	使用指定的地區設定，比較兩個 Unicode (寬字元) 字串。
FoldString	將一個字串對應到另一個字串，並執行指定的轉換選項。
GetStringTypeA	擷取指定來源字串中字元的字元類型資訊。 針對字串中的每個字元，函式會在輸出陣列的對應 16 位元素中設定一或多個位。 每個位都會識別指定的字元類型，例如字元是字母、數位或兩者皆非。
GetStringTypeEx	擷取指定來源字串中字元的字元類型資訊。 針對字串中的每個字元，函式會在輸出陣列的對應 16 位元素中設定一或多個位。 每個位都會識別指定的字元類型，例如字元是字母、數位或兩者皆非。 不同于其接近的 GetStringTypeA 和 GetStringTypeW， GetStringTypeEx 會透過使用 #define UNICODE 參數來展現標準行為。 這是建議的函式。
GetStringTypeW	擷取指定來源字串中字元的字元類型資訊。 針對字串中的每個字元，函式會在輸出陣列的對應 16 位元素中設定一或多個位。 每個位都會識別指定的字元類型，例如字元是字母、數位或兩者皆非。
IsCharAlpha	判斷字元是否為字母字元。 此判斷是以使用者在安裝期間或透過主控台所選取之語言的語意為基礎。
IsCharAlphaNumeric	判斷字元是字母或數值字元。 此判斷是以使用者在安裝期間或透過主控台所選取之語言的語意為基礎。
IsCharLower	判斷字元是否為小寫。 此判斷是以使用者在安裝期間或透過主控台所選取之語言的語意為基礎。
IsCharUpper	判斷字元是否為大寫。 此判斷是以使用者在安裝期間或透過主控台所選取之語言的語意為基礎。
LoadString	從與指定模組相關聯的可執行檔載入字串資源、將字串複製到緩衝區，並附加終止的 Null 字元。
lstrcat	將一個字串附加至另一個字串。
lstrcmp	比較兩個字元字串。 比較會區分大小寫。
lstrcmpi	比較兩個字元字串。 這項比較不會區分大小寫。
lstrcpy	將字串複製到緩衝區。
lstrcpyn	將指定數目的字元從來源字串複製到緩衝區。
lstrlen	決定指定的字串長度， (不包含終止的 null 字元) 。
OemToChar	將字串從 OEM 定義的字元集轉譯成 ANSI 或寬字元字串。
OemToCharBuff	將字串中的指定字元數從 OEM 定義的字元集轉譯成 ANSI 或寬字元字串。
wsprintf	將格式化的資料寫入指定的緩衝區。
wvsprintf	使用引數清單的指標，將格式化的資料寫入指定的緩衝區。

Strsafe 函式

名稱	描述
StringCbCat	將一個字串串連到另一個字串。
StringCbCatEx	將一個字串串連到另一個字串。
StringCbCatN	將指定的位元組數目從一個字串串連到另一個字串。
StringCbCatNEx	將指定的位元組數目從一個字串串連到另一個字串。
StringCbCopy	將一個字串複製到另一個字串。
StringCbCopyEx	將一個字串複製到另一個字串。
StringCbCopyN	將指定的位元組數目從一個字串複製到另一個字串。
StringCbCopyNEx	將指定的位元組數目從一個字串複製到另一個字串。
StringCbGets	從 stdin 取得一行文字，最多包含分行符號 ('\n') 。
StringCbGetsEx	從 stdin 取得一行文字，最多包含分行符號 ('\n') 。
StringCbLength	判斷字串是否超過指定的長度，以位元組為單位。
StringCbPrintf	將格式化的資料寫入指定的字串。
StringCbPrintfEx	將格式化的資料寫入指定的字串。
StringCbVPrintf	使用引數清單的指標，將格式化的資料寫入指定的字串。
StringCbVPrintfEx	使用引數清單的指標，將格式化的資料寫入指定的字串。
StringCchCat	將一個字串串連到另一個字串。
StringCchCatEx	將一個字串串連到另一個字串。
StringCchCatN	將指定的字元數從一個字串串連到另一個字串。
StringCchCatNEx	將指定的字元數從一個字串串連到另一個字串。
StringCchCopy	將一個字串複製到另一個字串。
StringCchCopyEx	將一個字串複製到另一個字串。
StringCchCopyN	將指定的字元數從一個字串複製到另一個字串。
StringCchCopyNEx	將指定的字元數從一個字串複製到另一個字串。
StringCchGets	從 stdin 取得一行文字，最多包含分行符號 ('\n') 。
StringCchGetsEx	從 stdin 取得一行文字，最多包含分行符號 ('\n') 。
StringCchLength	判斷字串是否超過指定的長度，以字元為單位。
StringCchPrintf	將格式化的資料寫入指定的字串。
StringCchPrintfEx	將格式化的資料寫入指定的字串。
StringCchVPrintf	使用引數清單的指標，將格式化的資料寫入指定的字串。
StringCchVPrintfEx	使用引數清單的指標，將格式化的資料寫入指定的字串。