CStringElementTraits 클래스

이 클래스는 개체를 저장하는 컬렉션 클래스에서 사용하는 정적 함수를 CString 제공합니다.

구문

template <typename T>
class CStringElementTraits

매개 변수

T
컬렉션에 저장할 데이터의 형식입니다.

멤버

공용 Typedefs

공용 메서드

설명

이 클래스는 문자열을 복사, 이동 및 비교하고 해시 값을 만들기 위한 정적 함수를 제공합니다. 이러한 함수는 컬렉션 클래스를 사용하여 문자열 기반 데이터를 저장할 때 유용합니다. 대/소문자를 구분하지 않는 비교가 필요한 경우 CStringElementTraitsI를 사용합니다. 문자열 개체를 참조로 처리할 때 CStringRefElementTraits를 사용합니다.

자세한 내용은 ATL 컬렉션 클래스를 참조 하세요.

요구 사항

헤더: cstringt.h

CStringElementTraits::CompareElements

이 정적 함수를 호출하여 두 문자열 요소를 같음으로 비교합니다.

static bool CompareElements(INARGTYPE str1, INARGTYPE str2);

매개 변수

str1
첫 번째 문자열 요소입니다.

str2
두 번째 문자열 요소입니다.

Return Value

요소가 같으면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

CStringElementTraits::CompareElementsOrdered

이 정적 함수를 호출하여 두 문자열 요소를 비교합니다.

static int CompareElementsOrdered(INARGTYPE str1, INARGTYPE str2);

매개 변수

str1
첫 번째 문자열 요소입니다.

str2
두 번째 문자열 요소입니다.

Return Value

문자열이 같으면 0, < str1이 str2보다 작으면 0, > str1이 str2보다 크면 0입니다. CStringT::Compare 메서드는 비교를 수행하는 데 사용됩니다.

CStringElementTraits::CopyElements

컬렉션 클래스 개체에 저장된 요소를 복사 CString 하려면 이 정적 함수를 호출합니다.

static void CopyElements(
    T* pDest,
    const T* pSrc,
    size_t nElements);

매개 변수

pDest
복사된 데이터를 받을 첫 번째 요소에 대한 포인터입니다.

pSrc
복사할 첫 번째 요소에 대한 포인터입니다.

nElements
복사할 요소의 수입니다.

설명

원본 및 대상 요소는 겹쳐서는 안 됩니다.

CStringElementTraits::Hash

이 정적 함수를 호출하여 지정된 문자열 요소에 대한 해시 값을 계산합니다.

static ULONG Hash(INARGTYPE str);

매개 변수

str
문자열 요소입니다.

Return Value

문자열의 내용을 사용하여 계산된 해시 값을 반환합니다.

CStringElementTraits::INARGTYPE

컬렉션 클래스 개체에 요소를 추가하는 데 사용할 데이터 형식입니다.

typedef T::PCXSTR INARGTYPE;

CStringElementTraits::OUTARGTYPE

컬렉션 클래스 개체에서 요소를 검색하는 데 사용할 데이터 형식입니다.

typedef T& OUTARGTYPE;

CStringElementTraits::RelocateElements

컬렉션 클래스 개체에 저장된 요소를 재배치 CString 하려면 이 정적 함수를 호출합니다.

static void RelocateElements(
    T* pDest,
    T* pSrc,
    size_t nElements);

매개 변수

pDest
재배치된 데이터를 받을 첫 번째 요소에 대한 포인터입니다.

pSrc
재배치할 첫 번째 요소에 대한 포인터입니다.

nElements
재배치할 요소의 수입니다.

설명

이 정적 함수는 대부분의 데이터 형식에 충분한 memmove를 호출합니다. 이동 중인 개체에 자체 멤버에 대한 포인터가 포함된 경우 이 정적 함수를 재정의해야 합니다.

참고 항목

CElementTraitsBase 클래스
CStringElementTraitsI 클래스
클래스 개요