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 類別