다음을 통해 공유

CTypedPtrArray 클래스

  • 아티클

CPtrArray 또는 CObArray클래스의 개체에 대해 형식 안전 "래퍼"를 제공합니다.

구문

template<class BASE_CLASS, class TYPE>
class CTypedPtrArray : public BASE_CLASS

매개 변수

BASE_CLASS
형식화된 포인터 배열 클래스의 기본 클래스입니다. 는 배열 클래스( CObArray 또는 CPtrArray)여야 합니다.

TYPE
기본 클래스 배열에 저장된 요소의 형식입니다.

멤버

공용 메서드

이름 설명
CTypedPtrArray::Add 배열의 끝에 새 요소를 추가합니다. 필요한 경우 배열을 늘입니다.
CTypedPtrArray::Append 한 배열의 내용을 다른 배열의 끝에 추가합니다. 필요한 경우 배열을 늘입니다.
CTypedPtrArray::Copy 배열에 다른 배열을 복사하고 필요하면 배열을 확장합니다.
CTypedPtrArray::ElementAt 배열 내의 요소 포인터에 대한 임시 참조를 반환합니다.
CTypedPtrArray::GetAt 지정된 인덱스의 값을 반환합니다.
CTypedPtrArray::InsertAt 지정한 인덱스에 요소 하나 또는 다른 배열의 모든 요소를 삽입합니다.
CTypedPtrArray::SetAt 지정된 인덱스의 값을 설정합니다. 배열은 확장할 수 없습니다.
CTypedPtrArray::SetAtGrow 지정된 인덱스의 값을 설정합니다. 필요한 경우 배열을 확장합니다.

Public 연산자

이름 설명
CTypedPtrArray::operator [ ] 지정한 인덱스에 있는 요소를 설정하거나 가져옵니다.

설명

C++ 형식 검사 기능을 사용하는 대신 CPtrArrayCObArray사용하면 CTypedPtrArray 일치하지 않는 포인터 형식으로 인한 오류를 제거할 수 있습니다.

또한 래퍼는 CTypedPtrArray 사용 CObArray 하거나 CPtrArray사용하는 경우 필요한 캐스팅의 대부분을 수행합니다.

모든 CTypedPtrArray 함수가 인라인이므로 이 템플릿을 사용하면 코드의 크기나 속도에 큰 영향을 주지 않습니다.

사용에 CTypedPtrArray대한 자세한 내용은 컬렉션 및 템플릿 기반 클래스 문서를 참조하세요.

상속 계층 구조

BASE_CLASS

CTypedPtrArray

요구 사항

헤더: afxtempl.h

CTypedPtrArray::Add

이 멤버 함수는 ::Add를 호출 BASE_CLASS합니다.

INT_PTR Add(TYPE newElement);

매개 변수

TYPE
배열에 추가할 요소의 형식을 지정하는 템플릿 매개 변수입니다.

newElement
이 배열에 추가할 요소입니다.

Return Value

추가된 요소의 인덱스입니다.

설명

자세한 설명은 CObArray::Add를 참조하세요.

CTypedPtrArray::Append

이 멤버 함수는 ::Append**를 호출 BASE_CLASS합니다.

INT_PTR Append(const CTypedPtrArray<BASE_CLASS, TYPE>& src);

매개 변수

BASE_CLASS
형식화된 포인터 배열 클래스의 기본 클래스입니다. 는 배열 클래스( CObArray 또는 CPtrArray)여야 합니다.

TYPE
기본 클래스 배열에 저장된 요소의 형식입니다.

src
배열에 추가할 요소의 원본입니다.

Return Value

추가된 첫 번째 요소의 인덱스입니다.

설명

자세한 설명은 CObArray::Append를 참조 하세요.

CTypedPtrArray::Copy

이 멤버 함수는 ::Copy를 호출BASE_CLASS합니다.

void Copy(const CTypedPtrArray<BASE_CLASS, TYPE>& src);

매개 변수

BASE_CLASS
형식화된 포인터 배열 클래스의 기본 클래스입니다. 는 배열 클래스( CObArray 또는 CPtrArray)여야 합니다.

TYPE
기본 클래스 배열에 저장된 요소의 형식입니다.

src
배열에 복사할 요소의 원본입니다.

설명

자세한 설명은 CObArray::Copy를 참조하세요.

CTypedPtrArray::ElementAt

이 인라인 함수는 ::ElementAt를 호출 BASE_CLASS합니다.

TYPE& ElementAt(INT_PTR nIndex);

매개 변수

TYPE
이 배열에 저장된 요소의 형식을 지정하는 템플릿 매개 변수입니다.

nIndex
::GetUpperBound에서 반환 BASE_CLASS된 값보다 크거나 같고 0보다 작거나 같은 정수 인덱스입니다.

Return Value

nIndex에서 지정한 위치에 있는 요소에 대한 임시 참조입니다. 이 요소는 템플릿 매개 변수 TYPE에 지정된 형식입니다.

설명

자세한 설명은 CObArray::ElementAt을 참조하세요.

CTypedPtrArray::GetAt

이 인라인 함수는 ::GetAt을 호출 BASE_CLASS합니다.

TYPE GetAt(INT_PTR nIndex) const;

매개 변수

TYPE
배열에 저장된 요소의 형식을 지정하는 템플릿 매개 변수입니다.

nIndex
::GetUpperBound에서 반환 BASE_CLASS된 값보다 크거나 같고 0보다 작거나 같은 정수 인덱스입니다.

Return Value

nIndex에서 지정한 위치에 있는 요소의 복사본입니다. 이 요소는 템플릿 매개 변수 TYPE에 지정된 형식입니다.

설명

자세한 설명은 CObArray::GetAt을 참조 하세요.

CTypedPtrArray::InsertAt

이 멤버 함수는 ::InsertAt를 호출 BASE_CLASS합니다.

void InsertAt(
    INT_PTR nIndex,
    TYPE newElement,
    INT_PTR nCount = 1);

void InsertAt(
    INT_PTR nStartIndex,
    CTypedPtrArray<BASE_CLASS, TYPE>* pNewArray);

매개 변수

nIndex
CObArray::GetUpperBound에서 반환하는 값보다 클 수 있는 정수 인덱스입니다.

TYPE
기본 클래스 배열에 저장된 요소의 형식입니다.

newElement
이 배열에 배치할 개체 포인터입니다. newElement 값 NULL이 허용됩니다.

nCount
이 요소를 삽입해야 하는 횟수입니다(기본값: 1).

nStartIndex
에서 반환 CObArray::GetUpperBound한 값보다 클 수 있는 정수 인덱스입니다.

BASE_CLASS
형식화된 포인터 배열 클래스의 기본 클래스입니다. 는 배열 클래스( CObArray 또는 CPtrArray)여야 합니다.

pNewArray
이 배열에 추가할 요소가 포함된 다른 배열입니다.

설명

자세한 설명은 CObArray::InsertAt를 참조 하세요.

CTypedPtrArray::operator [ ]

이러한 인라인 연산자는 ::operator [ ]를 호출BASE_CLASS합니다.

TYPE& operator[ ](int_ptr nindex);
TYPE operator[ ](int_ptr nindex) const;

매개 변수

TYPE
배열에 저장된 요소의 형식을 지정하는 템플릿 매개 변수입니다.

nIndex
::GetUpperBound에서 반환 BASE_CLASS된 값보다 크거나 같고 0보다 작거나 같은 정수 인덱스입니다.

설명

없는 const배열에 대해 호출된 첫 번째 연산자는 assignment 문의 오른쪽(r-value) 또는 왼쪽(l-value)에서 사용할 수 있습니다. 배열에 대해 const 호출되는 두 번째 작업은 오른쪽에서만 사용할 수 있습니다.

라이브러리의 디버그 버전은 할당 문의 왼쪽 또는 오른쪽에 있는 아래 첨자가 범위를 벗어나면 어설션됩니다.

CTypedPtrArray::SetAt

이 멤버 함수는 ::SetAt를 호출 BASE_CLASS합니다.

void SetAt(
    INT_PTR nIndex,
    TYPE ptr);

매개 변수

nIndex
CObArray::GetUpperBound에서 반환 된 값보다 크거나 같고 0보다 작거나 같은 정수 인덱스입니다.

TYPE
기본 클래스 배열에 저장된 요소의 형식입니다.

ptr
nIndex의 배열에 삽입할 요소에 대한 포인터입니다. NULL 값이 허용됩니다.

설명

자세한 설명은 CObArray::SetAt을 참조하세요.

CTypedPtrArray::SetAtGrow

이 멤버 함수는 ::SetAtGrow를 호출BASE_CLASS합니다.

void SetAtGrow(
    INT_PTR nIndex,
    TYPE newElement);

매개 변수

nIndex
0보다 크거나 같은 정수 인덱스입니다.

TYPE
기본 클래스 배열에 저장된 요소의 형식입니다.

newElement
이 배열에 추가할 개체 포인터입니다. NULL 값이 허용됩니다.

설명

자세한 설명은 CObArray::SetAtGrow를 참조하세요.

참고 항목

MFC 샘플 COLLECT
계층 구조 차트
CPtrArray 클래스
CObArray 클래스