CStringElementTraits 클래스
이 클래스는 개체를 저장하는 컬렉션 클래스에서 사용하는 정적 함수를 CString 제공합니다.
구문
template <typename T>
class CStringElementTraits
매개 변수
T
컬렉션에 저장할 데이터의 형식입니다.
멤버
공용 Typedefs
| 속성 | 설명 |
|---|---|
| CStringElementTraits::INARGTYPE | 컬렉션 클래스 개체에 요소를 추가하는 데 사용할 데이터 형식입니다. |
| CStringElementTraits::OUTARGTYPE | 컬렉션 클래스 개체에서 요소를 검색하는 데 사용할 데이터 형식입니다. |
공용 메서드
| 이름 | 설명 |
|---|---|
| CStringElementTraits::CompareElements | (정적) 이 함수를 호출하여 두 문자열 요소를 같음으로 비교합니다. |
| CStringElementTraits::CompareElementsOrdered | (정적) 이 함수를 호출하여 두 문자열 요소를 비교합니다. |
| CStringElementTraits::CopyElements | (정적) 컬렉션 클래스 개체에 저장된 요소를 복사 CString 하려면 이 함수를 호출합니다. |
| CStringElementTraits::Hash | (정적) 이 함수를 호출하여 지정된 문자열 요소에 대한 해시 값을 계산합니다. |
| CStringElementTraits::RelocateElements | (정적) 컬렉션 클래스 개체에 저장된 요소를 재배치 CString 하려면 이 함수를 호출합니다. |
설명
이 클래스는 문자열을 복사, 이동 및 비교하고 해시 값을 만들기 위한 정적 함수를 제공합니다. 이러한 함수는 컬렉션 클래스를 사용하여 문자열 기반 데이터를 저장할 때 유용합니다. 대/소문자를 구분하지 않는 비교가 필요한 경우 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를 호출합니다. 이동 중인 개체에 자체 멤버에 대한 포인터가 포함된 경우 이 정적 함수를 재정의해야 합니다.