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