CSimpleArray 클래스
이 클래스는 간단한 배열을 관리하기 위한 메서드를 제공합니다.
구문
template <class T, class TEqual = CSimpleArrayEqualHelper<T>>
class CSimpleArray
매개 변수
T
배열에 저장할 데이터의 형식입니다.
TEqual
T 형식의 요소에 대한 같음 테스트를 정의하는 특성 개체입니다.
멤버
공용 생성자
| 속성 | 설명 |
|---|---|
| CSimpleArray::CSimpleArray | 단순 배열의 생성자입니다. |
| CSimpleArray::~CSimpleArray | 단순 배열의 소멸자입니다. |
공용 메서드
| 이름 | 설명 |
|---|---|
| CSimpleArray::Add | 배열에 새 요소를 추가합니다. |
| CSimpleArray::Find | 배열에서 요소를 찾습니다. |
| CSimpleArray::GetData | 배열에 저장된 데이터에 대한 포인터를 반환합니다. |
| CSimpleArray::GetSize | 배열에 저장된 요소 수를 반환합니다. |
| CSimpleArray::Remove | 배열에서 지정된 요소를 제거합니다. |
| CSimpleArray::RemoveAll | 배열에서 모든 요소를 제거합니다. |
| CSimpleArray::RemoveAt | 배열에서 지정된 요소를 제거합니다. |
| CSimpleArray::SetAtIndex | 배열에서 지정된 요소를 설정합니다. |
Public 연산자
| 속성 | 설명 |
|---|---|
| CSimpleArray::operator[] | 배열에서 요소를 검색합니다. |
| CSimpleArray::operator = | 대입 연산자입니다. |
설명
CSimpleArray 에서는 지정된 형식 T의 간단한 배열을 만들고 관리하는 메서드를 제공합니다.
매개 변수 TEqual 는 형식 T의 두 요소에 대한 같음 함수를 정의하는 방법을 제공합니다. CSimpleArrayEqualHelper와 유사한 클래스를 만들면 지정된 배열에 대한 같음 테스트의 동작을 변경할 수 있습니다. 예를 들어 포인터 배열을 처리할 때 포인터가 참조하는 값에 따라 같음을 정의하는 것이 유용할 수 있습니다. 기본 구현은 operator=()를 사용합니다.
CSimpleMap CSimpleArray 과 CSimpleMap 은 적은 수의 요소를 위해 설계되었습니다. 배열에 많은 요소가 포함된 경우 CAtlArray 및 CAtlMap 을 사용해야 합니다.
요구 사항
헤더: atlsimpcoll.h
예시
// Create an array of integers
CSimpleArray<int> iArray;
// Create an array of char pointers
// and use a new equality function
CSimpleArray<char *, MyEqualityEqualHelper<char *> > cMyArray;
CSimpleArray::Add
배열에 새 요소를 추가합니다.
BOOL Add(const T& t);
매개 변수
t
배열에 추가할 요소입니다.
Return Value
요소가 배열에 성공적으로 추가되면 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다.
예시
// Create an array of integers and add some elements
CSimpleArray<int> iMyArray;
for (int i = 0; i < 10; i++)
iMyArray.Add(i);
CSimpleArray::CSimpleArray
배열 개체의 생성자입니다.
CSimpleArray(const CSimpleArray<T, TEqual>& src);
CSimpleArray();
매개 변수
src
기존 CSimpleArray 개체입니다.
설명
데이터 멤버를 초기화하여 빈 CSimpleArray 개체를 새로 만들거나 기존 CSimpleArray 개체의 복사본을 만듭니다.
CSimpleArray::~CSimpleArray
소멸자입니다.
~CSimpleArray();
설명
할당된 모든 리소스를 해제합니다.
CSimpleArray::Find
배열에서 요소를 찾습니다.
int Find(const T& t) const;
매개 변수
t
검색할 요소입니다.
Return Value
찾은 요소의 인덱스 또는 요소를 찾을 수 없는 경우 -1을 반환합니다.
예시
// Create an array of floats and search for a particular element
CSimpleArray<float> fMyArray;
for (int i = 0; i < 10; i++)
fMyArray.Add((float)i * 100);
int e = fMyArray.Find(200);
if (e == -1)
_tprintf_s(_T("Could not find element\n"));
else
_tprintf_s(_T("Found the element at location %d\n"), e);
CSimpleArray::GetData
배열에 저장된 데이터에 대한 포인터를 반환합니다.
T* GetData() const;
Return Value
배열의 데이터에 대한 포인터를 반환합니다.
CSimpleArray::GetSize
배열에 저장된 요소 수를 반환합니다.
int GetSize() const;
Return Value
배열에 저장된 요소 수를 반환합니다.
CSimpleArray::operator []
배열에서 요소를 검색합니다.
T& operator[](int nindex);
매개 변수
nIndex
요소 인덱스입니다.
Return Value
nIndex에서 참조하는 배열의 요소를 반환합니다.
예시
// Create an array and display its contents
CSimpleArray<int> iMySampleArray;
for (int i = 0; i < 10; i++)
iMySampleArray.Add(i);
for (int i = 0; i < iMySampleArray.GetSize(); i++)
_tprintf_s(_T("Array index %d contains %d\n"), i, iMySampleArray[i]);
CSimpleArray::operator =
대입 연산자입니다.
CSimpleArray<T, TEqual>
& operator=(
const CSimpleArray<T, TEqual>& src);
매개 변수
src
복사할 배열입니다.
Return Value
업데이트 CSimpleArray 된 개체에 대한 포인터를 반환합니다.
설명
src에서 참조하는 개체의 CSimpleArray 모든 요소를 현재 배열 개체로 복사하여 모든 기존 데이터를 대체합니다.
예시
// Create an array of chars and copy it to a second array
CSimpleArray<char> cMyArray1;
cMyArray1.Add('a');
CSimpleArray<char> cMyArray2;
cMyArray2 = cMyArray1;
ATLASSERT(cMyArray2[0] == 'a');
CSimpleArray::Remove
배열에서 지정된 요소를 제거합니다.
BOOL Remove(const T& t);
매개 변수
t
배열에서 제거할 요소입니다.
Return Value
요소를 찾아서 제거하면 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다.
설명
요소가 제거되면 배열의 나머지 요소는 빈 공간을 채우기 위해 다시 번호가 매겨집니다.
CSimpleArray::RemoveAll
배열에서 모든 요소를 제거합니다.
void RemoveAll();
설명
현재 배열에 저장된 모든 요소를 제거합니다.
CSimpleArray::RemoveAt
배열에서 지정된 요소를 제거합니다.
BOOL RemoveAtint nIndex);
매개 변수
nIndex
제거할 요소를 가리키는 인덱스입니다.
Return Value
요소가 제거되면 TRUE를 반환하고, 인덱스가 유효하지 않으면 FALSE를 반환합니다.
설명
요소가 제거되면 배열의 나머지 요소는 빈 공간을 채우기 위해 다시 번호가 매겨집니다.
CSimpleArray::SetAtIndex
배열에서 지정된 요소를 설정합니다.
BOOL SetAtIndex(
int nIndex,
const T& t);
매개 변수
nIndex
변경할 요소의 인덱스입니다.
t
지정된 요소에 할당할 값입니다.
Return Value
성공하면 TRUE를 반환하고, 인덱스가 유효하지 않으면 FALSE를 반환합니다.