IAtlStringMgr 클래스

이 클래스는 메모리 관리자에 대한 인터페이스를 CStringT 나타냅니다.

구문

__interface IAtlStringMgr

멤버

메서드

이름	설명
할당	새 문자열 데이터 구조를 할당하려면 이 메서드를 호출합니다.
복제	다른 인스턴스와 함께 사용할 새 문자열 관리자에 대한 포인터를 반환하려면 이 메서드를 호출합니다 CSimpleStringT.
무료	문자열 데이터 구조를 해제하려면 이 메서드를 호출합니다.
GetNilString	빈 문자열 개체에 사용되는 개체에 CStringData 대한 포인터를 반환합니다.
재할당	문자열 데이터 구조를 다시 할당하려면 이 메서드를 호출합니다.

설명

이 인터페이스는 MFC 독립적 문자열 클래스에서 사용하는 메모리를 관리합니다. CSimpleStringT, CStringT 및 CFixedStringT와 같은

이 클래스를 사용하여 사용자 지정 문자열 클래스에 대한 사용자 지정 메모리 관리자를 구현할 수도 있습니다. 자세한 내용은 메모리 관리 및 CStringT를 참조하세요.

요구 사항

헤더: atlsimpstr.h

IAtlStringMgr::Allocate

새 문자열 데이터 구조를 할당합니다.

CStringData* Allocate(int nAllocLength,int nCharSize) throw();

매개 변수

nAllocLength
새 메모리 블록의 문자 수입니다.

nCharSize
문자열 관리자가 사용하는 문자 형식의 크기(바이트)입니다.

Return Value

새로 할당된 메모리 블록에 대한 포인터를 반환합니다.

참고 항목

예외를 throw하여 실패한 할당에 대한 신호를 표시하지 마세요. 대신 NULL을 반환하여 실패한 할당에 신호를 보내야 합니다.

설명

IAtlStringMgr::Free 또는 IAtlStringMgr::ReAllocate를 호출하여 이 메서드에서 할당한 메모리를 해제합니다.

참고 항목

사용 예제는 메모리 관리 및 CStringT를 참조하세요.

IAtlStringMgr::Clone

다른 인스턴스와 함께 사용할 새 문자열 관리자에 대한 포인터를 반환합니다 CSimpleStringT.

IAtlStringMgr* Clone() throw();

Return Value

개체의 복사본을 IAtlStringMgr 반환합니다.

설명

새 문자열에 문자열 관리자가 필요한 경우 프레임워크에서 일반적으로 호출됩니다. 대부분의 경우 포인터가 this 반환됩니다.

그러나 메모리 관리자가 여러 인스턴스에서 CSimpleStringT사용되는 것을 지원하지 않는 경우 공유 가능한 문자열 관리자에 대한 포인터를 반환해야 합니다.

참고 항목

사용 예제는 메모리 관리 및 CStringT를 참조하세요.

IAtlStringMgr::Free

문자열 데이터 구조를 해제합니다.

void Free(CStringData* pData) throw();

매개 변수

pData
해제할 메모리 블록에 대한 포인터입니다.

설명

할당 또는 재할당에서 이전에 할당한 지정된 메모리 블록을 해제합니다.

참고 항목

사용 예제는 메모리 관리 및 CStringT를 참조하세요.

IAtlStringMgr::GetNilString

빈 문자열의 문자열 데이터 구조에 대한 포인터를 반환합니다.

CStringData* GetNilString() throw();

Return Value

빈 문자열을 CStringData 나타내는 데 사용되는 개체에 대한 포인터입니다.

설명

빈 문자열의 표현을 반환하려면 이 함수를 호출합니다.

참고 항목

사용자 지정 문자열 관리자를 구현할 때 이 함수는 실패하지 않아야 합니다. 문자열 관리자 클래스에 인스턴스를 포함하고 해당 인스턴스 CNilStringData 에 대한 포인터를 반환하여 이를 보장할 수 있습니다.

참고 항목

사용 예제는 메모리 관리 및 CStringT를 참조하세요.

IAtlStringMgr::Reallocate

문자열 데이터 구조를 다시 할당합니다.

CStringData* Reallocate(
    CStringData* pData,
    int nAllocLength,
    int nCharSize) throw();

매개 변수

pData
이 메모리 관리자가 이전에 할당한 메모리에 대한 포인터입니다.

nAllocLength
새 메모리 블록의 문자 수입니다.

nCharSize
문자열 관리자가 사용하는 문자 형식의 크기(바이트)입니다.

Return Value

새로 할당된 메모리 블록의 시작 부분에 대한 포인터를 반환합니다.

설명

pData에서 지정한 기존 메모리 블록의 크기를 조정하려면 이 함수를 호출합니다.

IAtlStringMgr::Free를 호출하여 이 메서드에서 할당한 메모리를 해제합니다.

참고 항목

사용 예제는 메모리 관리 및 CStringT를 참조하세요.

참고 항목

계층 구조 차트
ATL/MFC 공유 클래스