CStringRefElementTraits クラス

このクラスは、コレクション クラス オブジェクトに格納される文字列に関連する静的関数を提供します。 文字列オブジェクトは参照として扱われます。

構文

template <typename T>
class CStringRefElementTraits : public CElementTraitsBase<T>

パラメーター

T
コレクションに保存されるデータの型。

メンバー

パブリック メソッド

名前	説明
CStringRefElementTraits::CompareElements	2 つの文字列要素が等しいかどうかを比較するには、この静的関数を呼び出します。
CStringRefElementTraits::CompareElementsOrdered	2 つの文字列要素を比較するには、この静的関数を呼び出します。
CStringRefElementTraits::Hash	特定の文字列要素のハッシュ値を計算するには、この静的関数を呼び出します。

解説

このクラスでは、文字列を比較し、ハッシュ値を作成するための静的関数が提供されます。 これらの関数は、コレクション クラスを使用して文字列ベースのデータを格納する場合に便利です。 CStringElementTraits および CStringElementTraitsI とは異なり、CStringRefElementTraits の CString 引数は constCString& 参照として渡します。

詳細については、「ATL コレクション クラス」を参照してください。

継承階層

CElementTraitsBase

CStringRefElementTraits

必要条件

ヘッダー: atlcoll.h

CStringRefElementTraits::CompareElements

2 つの文字列要素が等しいかどうかを比較するには、この静的関数を呼び出します。

static bool CompareElements(INARGTYPE element1, INARGTYPE element2) throw();

パラメーター

element1
最初の文字列要素。

element2
2 つ目の文字列要素。

戻り値

要素が等しい場合は true、それ以外の場合は false を返します。

CStringRefElementTraits::CompareElementsOrdered

2 つの文字列要素を比較するには、この静的関数を呼び出します。

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

パラメーター

str1
最初の文字列要素。

str2
2 つ目の文字列要素。

戻り値

文字列が同一の場合は 0、str1 が str2 未満の場合は < 0、str1 が str2 より大きい場合は > 0 です。 この比較を実行するには、CStringT::Compare メソッドが使用されます。

CStringRefElementTraits::Hash

特定の文字列要素のハッシュ値を計算するには、この静的関数を呼び出します。

static ULONG Hash(INARGTYPE str) throw();

パラメーター

str
文字列要素。

戻り値

文字列の内容を使用して計算されたハッシュ値を返します。

関連項目

CElementTraitsBase クラス
クラスの概要