Platform::Collections::Vector 클래스
개별적으로 인덱스에 의해 액세스될 수 있는 개체의 순차적인 컬렉션을 나타냅니다. XAML 데이터 바인딩에 도움이 되도록 Windows::Foundation::Collections::IObservableVector를 구현합니다.
구문
template <typename T, typename E>
ref class Vector sealed;
매개 변수
T
Vector 개체에 포함된 요소의 형식입니다.
E
T 형식의 값과 같음을 테스트하기 위한 이진 조건자를 지정합니다. 기본값은 .입니다std::equal_to<T>.
설명
허용되는 형식은 다음과 같습니다.
integers
interface 클래스^
public ref 클래스 ^
value struct
public enum 클래스
Vector 클래스는 Windows::Foundation::Collections::IVector 인터페이스의 C++ 구체적인 구현입니다.
공용 반환 값 또는 매개 변수에서 Vector 형식을 사용하려고 하면 컴파일러 오류 C3986이 발생합니다. 매개 변수나 반환 값 형식을 Windows::Foundation::Collections::IVector로 변경하여 오류를 수정할 수 있습니다. 자세한 내용은 컬렉션(C++/CX)을 참조하세요.
멤버
공용 생성자
| 속성 | 설명 |
|---|---|
| Vector::Vector | Vector 클래스의 새 인스턴스를 초기화합니다. |
공용 메서드
| 이름 | 설명 |
|---|---|
| Vector::Append | 현재 Vector의 마지막 항목 다음에 지정된 항목을 삽입합니다. |
| Vector::Clear | 현재 Vector의 모든 요소를 삭제합니다. |
| Vector::First | Vector의 첫 번째 요소를 지정하는 반복기를 반환합니다. |
| Vector::GetAt | 지정된 인덱스로 식별되는 현재 Vector의 요소를 검색합니다. |
| Vector::GetMany | 현재 Vector에서 지정된 인덱스부터 시작하여 일련의 항목을 검색합니다. |
| Vector::GetView | Vector의 읽기 전용 보기, 즉 Platform::Collections::VectorView를 반환합니다. |
| Vector::IndexOf | 현재 Vector에서 지정한 항목을 검색하고 있는 경우 항목의 인덱스를 반환합니다. |
| Vector::InsertAt | 지정된 인덱스로 식별되는 요소의 현재 Vector에 지정된 항목을 삽입합니다. |
| Vector::ReplaceAll | 현재 Vector에서 요소를 삭제한 다음 지정된 배열의 요소를 삽입합니다. |
| Vector::RemoveAt | 현재 Vector에서 지정된 인덱스로 식별되는 요소를 삭제합니다. |
| Vector::RemoveAtEnd | 현재 Vector의 끝에 있는 요소를 삭제합니다. |
| Vector::SetAt | 현재 Vector에서 지정된 인덱스로 식별되는 요소에 지정된 값을 할당합니다. |
| Vector::Size | 현재 Vector 개체의 요소 수를 반환합니다. |
이벤트
| 이름 | 설명 |
|---|---|
| 이벤트 Windows::Foundation::Collection::VectorChangedEventHandler<T>^ VectorChanged | Vector가 변경될 때 발생합니다. |
상속 계층 구조
Vector
요구 사항
헤더: collection.h
네임스페이스: Platform::Collections
Vector::Append 메서드
현재 Vector의 마지막 항목 다음에 지정된 항목을 삽입합니다.
구문
virtual void Append(T item);
매개 변수
색인
Vector에 삽입할 항목입니다. 항목의 형식은 T 형식 이름으로 정의됩니다.
Vector::Clear 메서드
현재 Vector의 모든 요소를 삭제합니다.
구문
virtual void Clear();
Vector::First 메서드
Vector의 첫 번째 요소를 가리키는 반복기를 반환합니다.
구문
virtual Windows::Foundation::Collections::IIterator <T>^ First();
Return Value
Vector의 첫 번째 요소를 가리키는 반복기입니다.
설명
First()에서 반환된 반복기를 유지하는 편리한 방법은 형식 추론 키워드(keyword) 선언된 변수에 auto 반환 값을 할당하는 것입니다. 예: auto x = myVector->First();. 이 반복기는 컬렉션의 길이를 알고 있습니다.
STL 함수에 전달하기 위해 반복기 쌍이 필요한 경우 무료 함수 Windows::Foundation::Collections::begin 및 Windows::Foundation::Collections::end 함수를 사용합니다.
Vector::GetAt 메서드
지정된 인덱스로 식별되는 현재 Vector의 요소를 검색합니다.
구문
virtual T GetAt(unsigned int index);
매개 변수
색인
Vector 개체의 특정 요소를 지정하는 0부터 시작하는 부호 없는 정수입니다.
Return Value
인덱스 매개 변수로 지정된 요소입니다. 요소 형식은 T 형식 이름으로 정의됩니다.
Vector::GetMany 메서드
현재 Vector에서 지정된 인덱스부터 시작해 일련의 항목을 검색해서 호출자가 할당한 배열에 복사합니다.
구문
virtual unsigned int GetMany(
unsigned int startIndex,
Platform::WriteOnlyArray<T>^ dest);
매개 변수
Startindex
검색할 항목 시작 부분의 0부터 시작하는 인덱스입니다.
dest
startIndex로 지정된 요소에서 시작하고 Vector의 마지막 요소에서 끝나는 호출자가 할당한 항목 배열입니다.
Return Value
검색된 항목의 수입니다.
설명
이 함수는 클라이언트 코드에서 직접 사용하지 않습니다. to_vector 함수에서 내부적으로 사용되어 Platform::Vector intances를 std::vector 인스턴스로 효율적으로 변환할 수 있습니다.
Vector::GetView 메서드
Vector의 읽기 전용 보기, 즉 IVectorView를 반환합니다.
구문
Windows::Foundation::Collections::IVectorView<T>^ GetView();
Return Value
IVectorView 개체입니다.
Vector::IndexOf 메서드
현재 Vector에서 지정한 항목을 검색하고 있는 경우 항목의 인덱스를 반환합니다.
구문
virtual bool IndexOf(T value, unsigned int* index);
매개 변수
value
찾을 항목입니다.
인덱스
매개 변수 값 이 있으면 항목의 인덱스(0부터 시작하는 인덱스)이고, 그렇지 않으면 0입니다.
항목이 Vector의 첫 번째 요소이거나 항목을 찾을 수 없는 경우 인덱스 매개 변수는 0입니다. 반환 값이 true면 항목이 발견되고 첫 번째 요소이고, 그렇지 않으면 항목을 찾을 수 없습니다.
Return Value
true지정된 항목이 있으면 false
설명
IndexOf는 std::find_if를 사용하여 항목을 찾습니다. 그러므로 find_if에 필요한 같음 비교를 사용하려면 사용자 지정 요소 형식이 == 및 != 연산자를 오버로드해야 합니다.
Vector::InsertAt 메서드
지정된 인덱스로 식별되는 요소의 현재 Vector에 지정된 항목을 삽입합니다.
구문
virtual void InsertAt(unsigned int index, T item)
매개 변수
색인
Vector 개체의 특정 요소를 지정하는 0부터 시작하는 부호 없는 정수입니다.
항목
인덱스로 지정된 요소의 Vector에 삽입할 항목입니다. 항목의 형식은 T 형식 이름으로 정의됩니다.
Vector::RemoveAt 메서드
현재 Vector에서 지정된 인덱스로 식별되는 요소를 삭제합니다.
구문
virtual void RemoveAt(unsigned int index);
매개 변수
색인
Vector 개체의 특정 요소를 지정하는 0부터 시작하는 부호 없는 정수입니다.
Vector::RemoveAtEnd 메서드
현재 Vector의 끝에 있는 요소를 삭제합니다.
구문
virtual void RemoveAtEnd();
Vector::ReplaceAll 메서드
현재 Vector에서 요소를 삭제한 다음 지정된 배열의 요소를 삽입합니다.
구문
virtual void ReplaceAll(const ::Platform::Array<T>^ arr);
매개 변수
도착
형식이 T 형식 이름으로 정의된 개체의 배열입니다.
Vector::SetAt 메서드
현재 Vector에서 지정된 인덱스로 식별되는 요소에 지정된 값을 할당합니다.
구문
virtual void SetAt(unsigned int index, T item);
매개 변수
색인
Vector 개체의 특정 요소를 지정하는 0부터 시작하는 부호 없는 정수입니다.
항목
지정된 요소에 할당할 값입니다. 항목의 형식은 T 형식 이름으로 정의됩니다.
Vector::Size 메서드
현재 Vector 개체의 요소 수를 반환합니다.
구문
virtual property unsigned int Size;
Return Value
현재 Vector의 요소 수입니다.
Vector::Vector 생성자
Vector 클래스의 새 인스턴스를 초기화합니다.
구문
Vector();
explicit Vector(unsigned int size);
Vector( unsigned int size, T value);
template <typename U> explicit Vector( const ::std::vector<U>& v);
template <typename U> explicit Vector( std::vector<U>&& v);
Vector( const T * ptr, unsigned int size);
template <size_t N> explicit Vector(const T(&arr)[N]);
template <size_t N> explicit Vector(const std::array<T, N>& a);
explicit Vector(const Array<T>^ arr);
template <typename InIt> Vector(InIt first, InIt last);
Vector(std::initializer_list<T> il);
매개 변수
a
Vector를 초기화하는 데 사용할 std::array 입니다.
도착
벡터를 초기화하는 데 사용할 Platform::Array입니다.
Init
현재 Vector를 초기화하는 데 사용되는 개체 컬렉션의 형식입니다.
Il
Vector를 초기화하는 데 사용할 T 형식의 개체의 std::initializer_list.
N
현재 Vector를 초기화하는 데 사용되는 개체 컬렉션의 요소 수입니다.
size
Vector의 요소 수입니다.
value
현재 Vector의 각 요소를 초기화하는 데 사용되는 값입니다.
v
현재 벡터를 초기화하는 데 사용되는 std::vector에 대한 Lvalues 및 Rvalues입니다.
ptr
현재 Vector를 초기화하는 데 사용되는 std::vector에 대한 포인터입니다.
first
현재 Vector를 초기화하는 데 사용되는 개체 시퀀스의 첫 번째 요소입니다. 첫 번째 형식은 완벽한 전달을 통해 전달됩니다. 자세한 내용은 RValue 참조 선언자: &&를 참조하세요.
last
현재 Vector를 초기화하는 데 사용되는 개체 시퀀스의 마지막 요소입니다. 마지막 형식은 완벽한 전달을 통해 전달됩니다. 자세한 내용은 RValue 참조 선언자: &&를 참조하세요.
참고 항목
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기