使用 CString

本節中的主題會描述如何使用 CString 進行程式設計。 如需 類別 CString 的相關參考檔，請參閱 的檔 CStringT 。

若要使用 CString，請包括 atlstr.h 標頭。

CString、 CStringA 和 CStringW 類別是以所支援之字元資料類型為基礎的類別範本 CStringT 特製化。

CStringW物件包含 wchar_t 型別，並支援 Unicode 字串。 CStringA物件包含 char 類型，並支援單一位元組和多位元組 （MBCS） 字串。 CString物件支援 char 類型或 wchar_t 型別，視 MBCS 符號或 UNICODE 符號是在編譯時期定義而定。

CString 物件會在 CStringData 物件中保留字元資料。 CString 接受 Null 終止的 C 樣式字串。 CString 會追蹤字串長度以提升效能，但它也會保留 NULL 儲存字元資料中的字元，以支援轉換成 LPCWSTR 。 CString 包含匯出 C 樣式字串時的 Null 結束字元。 您可以在 中的其他 CString 位置插入 NULL ，但可能會產生非預期的結果。

使用下列字串類別集時，可以不連結 MFC 程式庫、及具有或不具有 CRT 支援：CAtlString、CAtlStringA 和 CAtlStringW。

CString 在原生專案中使用。 對於 Managed 程式碼 (C++/CLI) 專案，請使用 System::String。

若要加入比 CString、CStringA 或 CStringW 目前提供的更多功能，您應該建立包含其他功能的 CStringT 子類別。

下列程式碼會顯示如何建立 CString，且將其列印至標準輸出：

#include <atlstr.h>

int main() {
    CString aCString = CString(_T("A string"));
    _tprintf(_T("%s"), (LPCTSTR) aCString);
}

本節內容

基本 CString 作業
描述基本 CString 作業，包括從 C 常值字串建立物件，存取 CString 中的個別字元，串連兩個物件，以及比較 CString 物件。

字串資料管理
討論如何將 Unicode 及 MBCS 與 CString 搭配使用。

CString 語意
解釋如何使用 CString 物件。

與 C 樣式字串相關的 CString 作業
描述如何使用類似 C 樣式 null 結尾字串的方式，來操作 CString 物件的內容。

配置和釋放 的記憶體 BSTR
討論針對 BSTR 和 COM 物件使用記憶體。

CString 例外狀況清除
解釋 MFC 3.0 及以後版本中不再需要明確清除。

CString 引數傳遞
說明如何將物件傳遞 CString 至函式，以及如何從函式傳回 CString 物件。

Unicode 及多位元組字元集 (MBCS) 支援
討論如何針對 Unicode 及 MBCS 支援啟用 MFC。

參考

CStringT
提供 CStringT 類別的參考資訊。

CSimpleStringT 類
提供 CSimpleStringT 類別的參考資訊。

相關章節

字串 （ATL/MFC）
包含各主題的連結，描述管理字串資料的數個方法。

字串 （ATL/MFC）