CStringElementTraits Class
This class provides static functions used by collection classes storing CString objects.
template <typename T>
class CStringElementTraits
T
The type of data to be stored in the collection.
| Name | Description |
|---|---|
| CStringElementTraits::INARGTYPE | The data type to use for adding elements to the collection class object. |
| CStringElementTraits::OUTARGTYPE | The data type to use for retrieving elements from the collection class object. |
| Name | Description |
|---|---|
| CStringElementTraits::CompareElements | (Static) Call this function to compare two string elements for equality. |
| CStringElementTraits::CompareElementsOrdered | (Static) Call this function to compare two string elements. |
| CStringElementTraits::CopyElements | (Static) Call this function to copy CString elements stored in a collection class object. |
| CStringElementTraits::Hash | (Static) Call this function to calculate a hash value for the given string element. |
| CStringElementTraits::RelocateElements | (Static) Call this function to relocate CString elements stored in a collection class object. |
This class provides static functions for copying, moving, and comparing strings and for creating a hash value. These functions are useful when using a collection class to store string-based data. Use CStringElementTraitsI when case-insensitive comparisons are required. Use CStringRefElementTraits when the string objects are to be dealt with as references.
For more information, see ATL Collection Classes.
Header: cstringt.h
Call this static function to compare two string elements for equality.
static bool CompareElements(INARGTYPE str1, INARGTYPE str2);
str1
The first string element.
str2
The second string element.
Returns true if the elements are equal, false otherwise.
Call this static function to compare two string elements.
static int CompareElementsOrdered(INARGTYPE str1, INARGTYPE str2);
str1
The first string element.
str2
The second string element.
Zero if the strings are identical, < 0 if str1 is less than str2, or > 0 if str1 is greater than str2. The CStringT::Compare method is used to perform the comparisons.
Call this static function to copy CString elements stored in a collection class object.
static void CopyElements(
T* pDest,
const T* pSrc,
size_t nElements);
pDest
Pointer to the first element that will receive the copied data.
pSrc
Pointer to the first element to copy.
nElements
The number of elements to copy.
The source and destination elements should not overlap.
Call this static function to calculate a hash value for the given string element.
static ULONG Hash(INARGTYPE str);
str
The string element.
Returns a hash value, calculated using the string's contents.
The data type to use for adding elements to the collection class object.
typedef T::PCXSTR INARGTYPE;
The data type to use for retrieving elements from the collection class object.
typedef T& OUTARGTYPE;
Call this static function to relocate CString elements stored in a collection class object.
static void RelocateElements(
T* pDest,
T* pSrc,
size_t nElements);
pDest
Pointer to the first element that will receive the relocated data.
pSrc
Pointer to the first element to relocate.
nElements
The number of elements to relocate.
This static function calls memmove, which is sufficient for most data types. If the objects being moved contain pointers to their own members, this static function will need to be overridden.
CElementTraitsBase Class
CStringElementTraitsI Class
Class Overview