共用方式為


CStringElementTraitsI 類別

這個類別提供與儲存在集合類別物件中的字串相關的靜態函式。 它類似於 CStringElementTraits,但會執行不區分大小寫的比較。

語法

template <typename T, class CharTraits = CDefaultCharTraits<T ::XCHAR>>
class CStringElementTraitsI : public CElementTraitsBase<T>

參數

T
要儲存在集合中的數據型別。

成員

公用 Typedefs

名稱 描述
CStringElementTraitsI::INARGTYPE 要用於將專案加入至集合類別對象的數據類型。
CStringElementTraitsI::OUTARGTYPE 要用於從集合類別物件擷取專案的數據類型。

公用方法

名稱 描述
CStringElementTraitsI::CompareElements 呼叫此靜態函式來比較兩個字串元素是否相等,並忽略大小寫的差異。
CStringElementTraitsI::CompareElementsOrdered 呼叫此靜態函式來比較兩個字串元素,並忽略大小寫的差異。
CStringElementTraitsI::Hash 呼叫這個靜態函式來計算指定字串專案的哈希值。

備註

這個類別提供靜態函式來比較字串,以及建立哈希值。 使用集合類別來儲存字串型數據時,這些函式很有用。 當字串物件要以參考的形式處理時,請使用 CStringRefElementTraits

如需詳細資訊,請參閱 ATL 集合類別

繼承階層架構

CElementTraitsBase

CStringElementTraitsI

需求

標頭: atlcoll.h

CStringElementTraitsI::CompareElements

呼叫此靜態函式來比較兩個字串元素是否相等,並忽略大小寫的差異。

static bool CompareElements(INARGTYPE str1, INARGTYPE str2) throw();

參數

str1
第一個字串專案。

str2
第二個字串專案。

傳回值

如果專案相等,則傳回 true,否則傳回 false。

備註

比較不區分大小寫。

CStringElementTraitsI::CompareElementsOrdered

呼叫此靜態函式來比較兩個字串元素,並忽略大小寫的差異。

static int CompareElementsOrdered(INARGTYPE str1, INARGTYPE str2) throw();

參數

str1
第一個字串專案。

str2
第二個字串專案。

傳回值

如果字串相同,則為零,<如果 str1 小於 str2,則為 0;如果 str1 大於 str2,>則為 0。 CStringT ::Compare 方法可用來執行比較。

備註

比較不區分大小寫。

CStringElementTraitsI::Hash

呼叫這個靜態函式來計算指定字串專案的哈希值。

static ULONG Hash(INARGTYPE str) throw();

參數

str
字串專案。

傳回值

傳回哈希值,使用字串的內容計算。

CStringElementTraitsI::INARGTYPE

要用於將專案加入至集合類別對象的數據類型。

typedef T::PCXSTR INARGTYPE;

CStringElementTraitsI::OUTARGTYPE

要用於從集合類別物件擷取專案的數據類型。

typedef T& OUTARGTYPE;

另請參閱

CElementTraitsBase 類別
類別概觀
CStringElementTraits 類別