C++ Programmer's Cookbook

原著：Michael Dunn

翻譯：Chengjie Sun

原文出處：CodeProject：The Complete Guide to C++ Strings, Part I

引言

　　毫無疑問，我們都看到過像 TCHAR, std::string, BSTR 等各種各樣的字符串類型，還有那些以 _tcs 開頭的奇怪的宏。你也許正在盯著顯示器發(fā)愁。本指引將總結(jié)引進(jìn)各種字符類型的目的，展示一些簡單的用法，并告訴您在必要時，如何實現(xiàn)各種字符串類型之間的轉(zhuǎn)換。
　　在第一部分，我們將介紹3種字符編碼類型。了解各種編碼模式的工作方式是很重要的事情。即使你已經(jīng)知道一個字符串是一個字符數(shù)組，你也應(yīng)該閱讀本部分。一旦你了解了這些，你將對各種字符串類型之間的關(guān)系有一個清楚地了解。
　　在第二部分，我們將單獨講述string類，怎樣使用它及實現(xiàn)他們相互之間的轉(zhuǎn)換。

字符基礎(chǔ) -- ASCII, DBCS, Unicode

　　所有的 string 類都是以C-style字符串為基礎(chǔ)的。C-style 字符串是字符數(shù)組。所以我們先介紹字符類型。這里有3種編碼模式對應(yīng)3種字符類型。第一種編碼類型是單子節(jié)字符集（single-byte character set or SBCS）。在這種編碼模式下，所有的字符都只用一個字節(jié)表示。ASCII是SBCS。一個字節(jié)表示的0用來標(biāo)志SBCS字符串的結(jié)束。
　　第二種編碼模式是多字節(jié)字符集（multi-byte character set or MBCS）。一個MBCS編碼包含一些一個字節(jié)長的字符，而另一些字符大于一個字節(jié)的長度。用在Windows里的MBCS包含兩種字符類型，單字節(jié)字符（single-byte characters）和雙字節(jié)字符（double-byte characters）。由于Windows里使用的多字節(jié)字符絕大部分是兩個字節(jié)長，所以MBCS常被用DBCS代替。
　　在DBCS編碼模式中，一些特定的值被保留用來表明他們是雙字節(jié)字符的一部分。例如，在Shift-JIS編碼中（一個常用的日文編碼模式），0x81-0x9f之間和 0xe0-oxfc之間的值表示"這是一個雙字節(jié)字符，下一個子節(jié)是這個字符的一部分。"這樣的值被稱作"leading bytes",他們都大于0x7f。跟隨在一個leading byte子節(jié)后面的字節(jié)被稱作"trail byte"。在DBCS中，trail byte可以是任意非0值。像SBCS一樣，DBCS字符串的結(jié)束標(biāo)志也是一個單字節(jié)表示的0。
　　第三種編碼模式是Unicode。Unicode是一種所有的字符都使用兩個字節(jié)編碼的編碼模式。Unicode字符有時也被稱作寬字符，因為它比單子節(jié)字符寬（使用了更多的存儲空間）。注意，Unicode不能被看作MBCS。MBCS的獨特之處在于它的字符使用不同長度的字節(jié)編碼。Unicode字符串使用兩個字節(jié)表示的0作為它的結(jié)束標(biāo)志。
　　單字節(jié)字符包含拉丁文字母表，accented characters及ASCII標(biāo)準(zhǔn)和DOS操作系統(tǒng)定義的圖形字符。雙字節(jié)字符被用來表示東亞及中東的語言。Unicode被用在COM及Windows NT操作系統(tǒng)內(nèi)部。
　　你一定已經(jīng)很熟悉單字節(jié)字符。當(dāng)你使用char時，你處理的是單字節(jié)字符。雙字節(jié)字符也用char類型來進(jìn)行操作（這是我們將會看到的關(guān)于雙子節(jié)字符的很多奇怪的地方之一）。Unicode字符用wchar_t來表示。Unicode字符和字符串常量用前綴L來表示。例如：

wchar_t wch = L''1''; // 2 bytes, 0x0031
wchar_t* wsz = L"Hello"; // 12 bytes, 6 wide characters

字符在內(nèi)存中是怎樣存儲的

　　單字節(jié)字符串：每個字符占一個字節(jié)按順序依次存儲，最后以單字節(jié)表示的0結(jié)束。例如。"Bob"的存貯形式如下：

Unicode的存儲形式，L"Bob"

使用兩個字節(jié)表示的0來做結(jié)束標(biāo)志。

　　一眼看上去，DBCS 字符串很像 SBCS 字符串，但是我們一會兒將看到 DBCS 字符串的微妙之處，它使得使用字符串操作函數(shù)和永字符指針遍歷一個字符串時會產(chǎn)生預(yù)料之外的結(jié)果。字符串" " ("nihongo")在內(nèi)存中的存儲形式如下（LB和TB分別用來表示 leading byte 和 trail byte）

93 FA	96 7B	8C EA	00
LB TB	LB TB	LB TB	EOS
			EOS

值得注意的是，"ni"的值不能被解釋成WORD型值0xfa93，而應(yīng)該看作兩個值93和fa以這種順序被作為"ni"的編碼。

使用字符串處理函數(shù)

　　我們都已經(jīng)見過C語言中的字符串函數(shù)，strcpy(), sprintf(), atoll()等。這些字符串只應(yīng)該用來處理單字節(jié)字符字符串。標(biāo)準(zhǔn)庫也提供了僅適用于Unicode類型字符串的函數(shù)，比如wcscpy(), swprintf(), wtol()等。
　　微軟還在它的CRT(C runtime library)中增加了操作DBCS字符串的版本。Str***()函數(shù)都有對應(yīng)名字的DBCS版本_mbs***()。如果你料到可能會遇到DBCS字符串（如果你的軟件會被安裝在使用DBCS編碼的國家，如中國，日本等，你就可能會），你應(yīng)該使用_mbs***()函數(shù)，因為他們也可以處理SBCS字符串。（一個DBCS字符串也可能含有單字節(jié)字符，這就是為什么_mbs***()函數(shù)也能處理SBCS字符串的原因）
　　讓我們來看一個典型的字符串來闡明為什么需要不同版本的字符串處理函數(shù)。我們還是使用前面的Unicode字符串 L"Bob"：

　　因為x86CPU是little-endian，值0x0042在內(nèi)存中的存儲形式是42 00。你能看出如果這個字符串被傳給strlen()函數(shù)會出現(xiàn)什么問題嗎？它將先看到第一個字節(jié)42，然后是00，而00是字符串結(jié)束的標(biāo)志，于是strlen()將會返回1。如果把"Bob"傳給wcslen()，將會得出更壞的結(jié)果。wcslen()將會先看到0x6f42，然后是0x0062，然后一直讀到你的緩沖區(qū)的末尾，直到發(fā)現(xiàn)00 00結(jié)束標(biāo)志或者引起了GPF。
　　到目前為止，我們已經(jīng)討論了str***()和wcs***()的用法及它們之間的區(qū)別。Str***()和_mbs**()之間的有區(qū)別區(qū)別呢？明白他們之間的區(qū)別，對于采用正確的方法來遍歷DBCS字符串是很重要的。下面，我們將先介紹字符串的遍歷，然后回到str***()與_mbs***()之間的區(qū)別這個問題上來。

正確的遍歷和索引字符串

　　因為我們中大多數(shù)人都是用著SBCS字符串成長的，所以我們在遍歷字符串時，常常使用指針的++-和-操作。我們也使用數(shù)組下標(biāo)的表示形式來操作字符串中的字符。這兩種方式是用于SBCS和Unicode字符串，因為它們中的字符有著相同的寬度，編譯器能正確的返回我們需要的字符。
　　然而，當(dāng)碰到DBCS字符串時，我們必須拋棄這些習(xí)慣。這里有使用指針遍歷DBCS字符串時的兩條規(guī)則。違背了這兩條規(guī)則，你的程序就會存在DBCS有關(guān)的bugs。

　　我們先來闡述規(guī)則2，因為找到一個違背它的真實的實例代碼是很容易的。假設(shè)你有一個程序在你自己的目錄里保存了一個設(shè)置文件，你把安裝目錄保存在注冊表中。在運行時，你從注冊表中讀取安裝目錄，然后合成配置文件名，接著讀取該文件。假設(shè)，你的安裝目錄是C:\Program Files\MyCoolApp，那么你合成的文件名應(yīng)該是C:\Program Files\MyCoolApp\config.bin。當(dāng)你進(jìn)行測試時，你發(fā)現(xiàn)程序運行正常。
　　現(xiàn)在，想象你合成文件名的代碼可能是這樣的：

bool GetConfigFileName ( char* pszName, size_t nBuffSize )
{
    char szConfigFilename[MAX_PATH];
 
    // Read install dir from registry... we''ll assume it succeeds.
 
    // Add on a backslash if it wasn''t present in the registry value.
    // First, get a pointer to the terminating zero.
    char* pLastChar = strchr ( szConfigFilename, '''' );
 
    // Now move it back one character.
    pLastChar--;  
 
    if ( *pLastChar != ''\\'' )
        strcat ( szConfigFilename, "\\" );
 
    // Add on the name of the config file.
    strcat ( szConfigFilename, "config.bin" );
 
    // If the caller''s buffer is big enough, return the filename.
    if ( strlen ( szConfigFilename ) >= nBuffSize )
        return false;
    else
        {
        strcpy ( pszName, szConfigFilename );
        return true;
        }
}      

43	3A	5C	83 88	83 45	83 52	83 5C	00
			LB TB	LB TB	LB TB	LB TB
C	:	\					EOS

　　當(dāng)使用 GetConfigFileName() 檢查尾部的''\\''時，它尋找安裝目錄名中最后的非0字節(jié)，看它是等于''\\''的，所以沒有重新增加一個''\\''。結(jié)果是代碼返回了錯誤的文件名。
　　哪里出錯了呢？看看上面兩個被用藍(lán)色高量顯示的字節(jié)。斜杠''\\''的值是0x5c。'' ''的值是83 5c。上面的代碼錯誤的讀取了一個 trail byte，把它當(dāng)作了一個字符。
　　正確的后向遍歷方法是使用能夠識別DBCS字符的函數(shù)，使指針移動正確的字節(jié)數(shù)。下面是正確的代碼。（指針移動的地方用紅色標(biāo)明）

bool FixedGetConfigFileName ( char* pszName, size_t nBuffSize )
{
    char szConfigFilename[MAX_PATH];
 
    // Read install dir from registry... we''ll assume it succeeds.
 
    // Add on a backslash if it wasn''t present in the registry value.
    // First, get a pointer to the terminating zero.
    char* pLastChar = _mbschr ( szConfigFilename, '''' );
 
    // Now move it back one double-byte character.
    pLastChar = CharPrev ( szConfigFilename, pLastChar );
 
    if ( *pLastChar != ''\\'' )
        _mbscat ( szConfigFilename, "\\" );
 
    // Add on the name of the config file.
    _mbscat ( szConfigFilename, "config.bin" );

     // If the caller''s buffer is big enough, return the filename.
    if ( _mbslen ( szInstallDir ) >= nBuffSize )
        return false;
    else
        {
        _mbscpy ( pszName, szConfigFilename );
        return true;
        }
}

2a. 永遠(yuǎn)不要使用減法去得到一個字符串的索引。

違背這條規(guī)則的代碼和違背規(guī)則2的代碼很相似。例如，

char* pLastChar = &szConfigFilename [strlen(szConfigFilename) - 1];

這和向后移動一個指針是同樣的效果。

回到關(guān)于str***()和_mbs***()的區(qū)別

　　現(xiàn)在，我們應(yīng)該很清楚為什么_mbs***()函數(shù)是必需的。Str***()函數(shù)根本不考慮DBCS字符，而_mbs***()考慮。如果，你調(diào)用strrchr("C:\\ ", ''\\'')，返回結(jié)果可能是錯誤的，然而_mbsrchr()將會認(rèn)出最后的雙字節(jié)字符，返回一個指向真的''\\''的指針。
　　關(guān)于字符串函數(shù)的最后一點：str***()和_mbs***()函數(shù)認(rèn)為字符串的長度都是以char來計算的。所以，如果一個字符串包含3個雙字節(jié)字符，_mbslen()將會返回6。Unicode函數(shù)返回的長度是按wchar_t來計算的。例如，wcslen(L"Bob")返回3。

Win32 API中的MBCS和Unicode

兩組 APIs：
　　盡管你也許從來沒有注意過，Win32中的每個與字符串相關(guān)的API和message都有兩個版本。一個版本接受MBCS字符串，另一個接受Unicode字符串。例如，根本沒有SetWindowText()這個API，相反，有SetWindowTextA()和SetWindowTextW()。后綴A表明這是MBCS函數(shù)，后綴W表示這是Unicode版本的函數(shù)。
　　當(dāng)你 build 一個 Windows 程序，你可以選擇是用 MBCS 或者 Unicode APIs。如果，你曾經(jīng)用過VC向?qū)Р⑶覜]有改過預(yù)處理的設(shè)置，那表明你用的是MBCS版本。那么，既然沒有 SetWindowText() API，我們?yōu)槭裁纯梢允褂盟兀縲inuser.h頭文件包含了一些宏，例如：

BOOL WINAPI SetWindowTextA ( HWND hWnd, LPCSTR lpString );
BOOL WINAPI SetWindowTextW ( HWND hWnd, LPCWSTR lpString );
 
#ifdef UNICODE
#define SetWindowText  SetWindowTextW
#else
#define SetWindowText  SetWindowTextA
#endif      

#define SetWindowText SetWindowTextA

　　這個宏定義把所有對SetWindowText的調(diào)用都轉(zhuǎn)換成真正的API函數(shù)SetWindowTextA。（當(dāng)然，你可以直接調(diào)用SetWindowTextA() 或者 SetWindowTextW()，雖然你不必那么做。）
　　所以，如果你想把默認(rèn)使用的API函數(shù)變成Unicode版的，你可以在預(yù)處理器設(shè)置中，把_MBCS從預(yù)定義的宏列表中刪除，然后添加UNICODE和_UNICODE。(你需要兩個都定義，因為不同的頭文件可能使用不同的宏。) 然而，如果你用char來定義你的字符串，你將會陷入一個尷尬的境地。考慮下面的代碼：

HWND hwnd = GetSomeWindowHandle();
char szNewText[] = "we love Bob!";
SetWindowText ( hwnd, szNewText );

在預(yù)處理器把SetWindowText用SetWindowTextW來替換后，代碼變成：

HWND hwnd = GetSomeWindowHandle();
char szNewText[] = "we love Bob!";
SetWindowTextW ( hwnd, szNewText );

　　看到問題了嗎？我們把單字節(jié)字符串傳給了一個以Unicode字符串做參數(shù)的函數(shù)。解決這個問題的第一個方案是使用 #ifdef 來包含字符串變量的定義：

HWND hwnd = GetSomeWindowHandle();
#ifdef UNICODE
wchar_t szNewText[] = L"we love Bob!";
#else
char szNewText[] = "we love Bob!";
#endif
SetWindowText ( hwnd, szNewText );

你可能已經(jīng)感受到了這樣做將會使你多么的頭疼。完美的解決方案是使用TCHAR.

使用TCHAR

　　TCHAR是一種字符串類型，它讓你在以MBCS和UNNICODE來build程序時可以使用同樣的代碼，不需要使用繁瑣的宏定義來包含你的代碼。TCHAR的定義如下：

#ifdef UNICODE
typedef wchar_t TCHAR;
#else
typedef char TCHAR;
#endif

所以用MBCS來build時，TCHAR是char，使用UNICODE時，TCHAR是wchar_t。還有一個宏來處理定義Unicode字符串常量時所需的L前綴。

#ifdef UNICODE
#define _T(x) L##x
#else
#define _T(x) x
#endif

　　##是一個預(yù)處理操作符，它可以把兩個參數(shù)連在一起。如果你的代碼中需要字符串常量，在它前面加上_T宏。如果你使用Unicode來build，它會在字符串常量前加上L前綴。

TCHAR szNewText[] = _T("we love Bob!");

　　像是用宏來隱藏SetWindowTextA/W的細(xì)節(jié)一樣，還有很多可以供你使用的宏來實現(xiàn)str***()和_mbs***()等字符串函數(shù)。例如，你可以使用_tcsrchr宏來替換strrchr()、_mbsrchr()和wcsrchr()。_tcsrchr根據(jù)你預(yù)定義的宏是_MBCS還是UNICODE來擴展成正確的函數(shù)，就像SetWindowText所作的一樣。
　　不僅str***()函數(shù)有TCHAR宏。其他的函數(shù)如， _stprintf（代替sprinft()和swprintf()）,_tfopen（代替fopen()和_wfopen()）。 MSDN中"Generic-Text Routine Mappings."標(biāo)題下有完整的宏列表。

字符串和TCHAR typedefs

　　由于Win32 API文檔的函數(shù)列表使用函數(shù)的常用名字（例如，"SetWindowText"），所有的字符串都是用TCHAR來定義的。（除了XP中引入的只適用于Unicode的API）。下面列出一些常用的typedefs，你可以在msdn中看到他們。

何時使用 TCHAR 和 Unicode

　　到現(xiàn)在，你可能會問，我們?yōu)槭裁匆褂肬nicode。我已經(jīng)用了很多年的char。下列3種情況下，使用Unicode將會使你受益：

　　Windows 9x 中大多數(shù)的 API 沒有實現(xiàn) Unicode 版本。所以，如果你的程序要在windows 9x中運行，你必須使用MBCS APIs。然而，由于NT系統(tǒng)內(nèi)部都使用Unicode，所以使用Unicode APIs將會加快你的程序的運行速度。每次，你傳遞一個字符串調(diào)用MBCS API，操作系統(tǒng)會把這個字符串轉(zhuǎn)換成Unicode字符串，然后調(diào)用對應(yīng)的Unicode API。如果一個字符串被返回，操作系統(tǒng)還要把它轉(zhuǎn)變回去。盡管這個轉(zhuǎn)換過程被高度優(yōu)化了，但它對速度造成的損失是無法避免的。
　　只要你使用Unicode API，NT系統(tǒng)允許使用非常長的文件名（突破了MAX_PATH的限制，MAX_PATH=260）。使用Unicode API的另一個優(yōu)點是你的程序會自動處理用戶輸入的各種語言。所以一個用戶可以輸入英文，中文或者日文，而你不需要額外編寫代碼去處理它們。
　　最后，隨著windows 9x產(chǎn)品的淡出，微軟似乎正在拋棄MBCS APIs。例如，包含兩個字符串參數(shù)的SetWindowTheme() API只有Unicode版本的。使用Unicode來build你的程序?qū)喕址奶幚恚悴槐卦贛BCS和Unicdoe之間相互轉(zhuǎn)換。
　　即使你現(xiàn)在不使用Unicode來build你的程序，你也應(yīng)該使用TCHAR及其相關(guān)的宏。這樣做不僅可以的代碼可以很好地處理DBCS，而且如果將來你想用Unicode來build你的程序，你只需要改變一下預(yù)處理器中的設(shè)置就可以實現(xiàn)了。