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++ 형식 검사 기능을 사용하는 대신 CPtrArray CObArray사용하는 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를 참조하세요.