다음을 통해 공유


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
두 번째 문자열 요소입니다.

Return Value

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

설명

비교는 대/소문자를 구분하지 않습니다.

CStringElementTraitsI::CompareElementsOrdered

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

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

매개 변수

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

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

Return Value

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

설명

비교는 대/소문자를 구분하지 않습니다.

CStringElementTraitsI::Hash

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

static ULONG Hash(INARGTYPE str) throw();

매개 변수

str
문자열 요소입니다.

Return Value

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

CStringElementTraitsI::INARGTYPE

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

typedef T::PCXSTR INARGTYPE;

CStringElementTraitsI::OUTARGTYPE

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

typedef T& OUTARGTYPE;

참고 항목

CElementTraitsBase 클래스
클래스 개요
CStringElementTraits 클래스