CStringArray 수업
CString 개체 배열을 지원합니다.
구문
class CStringArray : public CObject
멤버
의 CStringArray 멤버 함수는 클래스 CObArray의 멤버 함수와 유사합니다. 이처럼 두 함수가 비슷하므로 CObArray 참조 설명서에서 멤버 함수 관련 사항을 확인할 수 있습니다. 포인터를 CObject 반환 값으로 볼 때마다 포인터가 아닌 개체를 CString CString 대체합니다. CObject 포인터가 함수 매개 변수로 사용될 때마다 LPCTSTR을 대체합니다.
CObject* CObArray::GetAt( int <nIndex> ) const;
예를 들어 위의 코드는
const CString& CStringArray::GetAt( int <nIndex> ) const;
및
void SetAt( int <nIndex>, CObject* <newElement> )
위의 코드는 다음과 같이 변환됩니다.
void SetAt( int <nIndex>, LPCTSTR <newElement> )
공용 생성자
| 속성 | 설명 |
|---|---|
CStringArray::CStringArray |
빈 배열을 생성합니다. |
공용 메서드
| 이름 | 설명 |
|---|---|
CStringArray::Add |
배열 끝에 요소를 추가하고 필요하면 배열을 확장합니다. |
CStringArray::Append |
배열에 다른 배열을 추가하고 필요하면 배열을 확장합니다. |
CStringArray::Copy |
배열에 다른 배열을 복사하고 필요하면 배열을 확장합니다. |
CStringArray::ElementAt |
배열 내의 요소 포인터에 대한 임시 참조를 반환합니다. |
CStringArray::FreeExtra |
현재 상한을 초과하며 사용되지 않는 모든 메모리를 해제합니다. |
CStringArray::GetAt |
지정된 인덱스의 값을 반환합니다. |
CStringArray::GetCount |
이 배열에 있는 요소의 수를 가져옵니다. |
CStringArray::GetData |
배열의 요소에 대한 액세스를 허용합니다. NULL일 수 있습니다. |
CStringArray::GetSize |
이 배열에 있는 요소의 수를 가져옵니다. |
CStringArray::GetUpperBound |
유효한 최대 인덱스를 반환합니다. |
CStringArray::InsertAt |
지정한 인덱스에 요소 하나 또는 다른 배열의 모든 요소를 삽입합니다. |
CStringArray::IsEmpty |
배열이 비어 있는지를 확인합니다. |
CStringArray::RemoveAll |
이 배열의 모든 요소를 반환합니다. |
CStringArray::RemoveAt |
특정 인덱스의 요소를 제거합니다. |
CStringArray::SetAt |
지정된 인덱스의 값을 설정합니다. 배열은 확장할 수 없습니다. |
CStringArray::SetAtGrow |
지정된 인덱스의 값을 설정합니다. 필요한 경우 배열을 확장합니다. |
CStringArray::SetSize |
이 배열에 포함된 요소의 수를 설정합니다. |
Public 연산자
| 속성 | 설명 |
|---|---|
CStringArray::operator [ ] |
지정한 인덱스에 있는 요소를 설정하거나 가져옵니다. |
설명
CStringArray는 serialization 및 요소 덤프를 지원하기 위해 IMPLEMENT_SERIAL 매크로를 통합합니다. 오버로드된 삽입 연산자 또는 CString 멤버 함수를 사용하여 Serialize 개체 배열을 보관 파일에 저장하는 경우에는 각 요소가 차례로 serialize됩니다.
참고 항목
배열을 사용하기 전에 SetSize를 사용하여 배열 크기를 설정하고 배열에 대해 메모리를 할당합니다. SetSize를 사용하지 않는 경우 배열에 요소를 추가하면 배열이 자주 다시 할당되고 복사됩니다. 이처럼 다시 할당 및 복사가 자주 수행되면 효율성이 떨어지며 메모리가 조각화될 수 있습니다.
배열에 개별 문자열 요소의 덤프가 필요하면 덤프 컨텍스트의 수준을 1 이상으로 설정해야 합니다.
CString 배열을 삭제하거나 해당 요소를 제거하면 문자열 메모리가 적절하게 해제됩니다.
사용에 CStringArray대한 자세한 내용은 컬렉션 문서를 참조하세요.
상속 계층 구조
CStringArray
요구 사항
머리글: afxcoll.h