Platform::Collections::Vector 클래스Platform::Collections::Vector Class

개별적으로 인덱스에 의해 액세스될 수 있는 개체의 순차적인 컬렉션을 나타냅니다.Represents a sequential collection of objects that can be individually accessed by index. XAML 데이터 바인딩을지원 하기 위해 Windows:: Foundation:: Collections:: IObservableVector 을 구현 합니다.Implements Windows::Foundation::Collections::IObservableVector to help with XAML data binding.

구문Syntax

template <typename T, typename E>
   ref class Vector sealed;

매개 변수Parameters

TT
Vector 개체에 포함된 요소의 형식입니다.The type of the elements contained in the Vector object.

우표E
T형식의 값과 같은지 테스트 하기 위한 이진 조건자를 지정 합니다. 기본값은 std::equal_to<T> 입니다.Specifies a binary predicate for testing equality with values of type T. The default value is std::equal_to<T>.

설명Remarks

허용 유형은 다음과 같습니다.Allowed types are:

  1. integersintegers

  2. 인터페이스 클래스 ^interface class^

  3. public ref 클래스 ^public ref class^

  4. value structvalue struct

  5. public enum 클래스public enum class

Vector 클래스는 Windows:: Foundation:: Collections:: IVector 인터페이스의 구체적인 c + + 구현입니다.The Vector class is the C++ concrete implementation of the Windows::Foundation::Collections::IVector interface.

공용 반환 값 또는 매개 변수에서 Vector 형식을 사용 하려고 하면 컴파일러 오류 c 3986이 발생 합니다.If you attempt to use a Vector type in a public return value or parameter, compiler error C3986 is raised. 매개 변수나 반환 값 형식을 Windows::Foundation::Collections::IVector로 변경하여 오류를 수정할 수 있습니다.You can fix the error by changing the parameter or return value type to Windows::Foundation::Collections::IVector. 자세한 내용은 컬렉션(C++/CX)을 참조하세요.For more information, see Collections (C++/CX).

멤버Members

Public 생성자Public Constructors

이름Name 설명Description
Vector:: VectorVector::Vector Vector 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the Vector class.

Public 메서드Public Methods

이름Name 설명Description
Vector::AppendVector::Append 현재 Vector의 마지막 항목 다음에 지정된 항목을 삽입합니다.Inserts the specified item after the last item in the current Vector.
Vector:: ClearVector::Clear 현재 Vector의 모든 요소를 삭제합니다.Deletes all the elements in the current Vector.
Vector:: FirstVector::First Vector의 첫 번째 요소를 지정하는 반복기를 반환합니다.Returns an iterator that specifies the first element in the Vector.
Vector:: GetAtVector::GetAt 지정된 인덱스로 식별되는 현재 Vector의 요소를 검색합니다.Retrieves the element of the current Vector that is identifed by the specified index.
Vector:: GetManyVector::GetMany 현재 Vector에서 지정된 인덱스부터 시작하여 일련의 항목을 검색합니다.Retrieves a sequence of items from the current Vector, starting at the specified index.
Vector:: GetViewVector::GetView Vector의 읽기 전용 보기, 즉 Platform::Collections::VectorView를 반환합니다.Returns a read-only view of a Vector; that is, a Platform::Collections::VectorView.
Vector:: IndexOfVector::IndexOf 현재 Vector에서 지정한 항목을 검색하고 있는 경우 항목의 인덱스를 반환합니다.Searches for the specified item in the current Vector, and if found, returns the index of the item.
Vector::InsertAtVector::InsertAt 지정 된 항목을 지정 된 인덱스로 식별 되는 요소의 현재 Vector에 삽입 합니다.Inserts the specified item into the current Vector at the element identified by the specified index.
Vector::ReplaceAllVector::ReplaceAll 현재 Vector에서 요소를 삭제한 다음 지정된 배열의 요소를 삽입합니다.Deletes the elements in the current Vector and then inserts the elements from the specified array.
Vector::RemoveAtVector::RemoveAt 현재 Vector에서 지정된 인덱스로 식별되는 요소를 삭제합니다.Deletes the element identified by the specified index from the current Vector.
Vector::RemoveAtEndVector::RemoveAtEnd 현재 Vector의 끝에 있는 요소를 삭제합니다.Deletes the element at the end of the current Vector.
Vector::SetAtVector::SetAt 현재 Vector에서 지정된 인덱스로 식별되는 요소에 지정된 값을 할당합니다.Assigns the specified value to the element in the current Vector that is identified by the specified index.
Vector:: SizeVector::Size 현재 Vector 개체의 요소 수를 반환합니다.Returns the number of elements in the current Vector object.

이벤트Events

NameName 설명Description
이벤트 Windows:: Foundation:: Collection:: VectorChangedEventHandler <T> ^ VectorChangedevent Windows::Foundation::Collection::VectorChangedEventHandler<T>^ VectorChanged Vector가 변경될 때 발생합니다.Occurs when the Vector changes.

상속 계층 구조Inheritance Hierarchy

Vector

요구 사항Requirements

헤더: collection .hHeader: collection.h

네임스페이스: Platform::CollectionsNamespace: Platform::Collections

Vector:: Append 메서드Vector::Append Method

현재 Vector의 마지막 항목 다음에 지정된 항목을 삽입합니다.Inserts the specified item after the last item in the current Vector.

구문Syntax

virtual void Append(T item);

매개 변수Parameters

indexindex
Vector에 삽입할 항목입니다.The item to insert into the Vector. 항목 의 형식은 T 형식 이름으로 정의 됩니다.The type of item is defined by the T typename.

Vector:: Clear 메서드Vector::Clear Method

현재 Vector의 모든 요소를 삭제합니다.Deletes all the elements in the current Vector.

구문Syntax

virtual void Clear();

Vector:: First 메서드Vector::First Method

Vector의 첫 번째 요소를 가리키는 반복기를 반환합니다.Returns an iterator that points to the first element in the Vector.

구문Syntax

virtual Windows::Foundation::Collections::IIterator <T>^ First();

Return ValueReturn Value

Vector의 첫 번째 요소를 가리키는 반복기입니다.An iterator that points to the first element in the Vector.

설명Remarks

First ()에서 반환 된 반복기를 편리 하 게 유지 하는 방법은 형식 추론 키워드를 사용 하 여 선언 된 변수에 반환 값을 할당 하는 것입니다 auto .A convenient way to hold the iterator returned by First() is to assign the return value to a variable that is declared with the auto type deduction keyword. 예: auto x = myVector->First();.For example, auto x = myVector->First();. 이 반복기는 컬렉션의 길이를 알고 있습니다.This iterator knows the length of the collection.

STL 함수에 전달할 반복기 쌍이 필요한 경우 free 함수 Windows:: foundation:: collections:: beginWindows:: Foundation:: collections:: end 를 사용 합니다.When you need a pair of iterators to pass to an STL function, use the free functions Windows::Foundation::Collections::begin and Windows::Foundation::Collections::end

Vector:: GetAt 메서드Vector::GetAt Method

지정된 인덱스로 식별되는 현재 Vector의 요소를 검색합니다.Retrieves the element of the current Vector that is identifed by the specified index.

구문Syntax

virtual T GetAt(unsigned int index);

매개 변수Parameters

indexindex
Vector 개체의 특정 요소를 지정하는 0부터 시작하는 부호 없는 정수입니다.A zero-based, unsigned integer that specifies a particular element in the Vector object.

반환 값Return Value

Index 매개 변수로 지정 된 요소입니다.The element specified by the index parameter. 요소 형식은 T 형식 이름으로 정의 됩니다.The element type is defined by the T typename.

Vector:: GetMany 메서드Vector::GetMany Method

현재 Vector에서 지정된 인덱스부터 시작해 일련의 항목을 검색해서 호출자가 할당한 배열에 복사합니다.Retrieves a sequence of items from the current Vector, starting at the specified index, and copies them into the caller-allocated array.

구문Syntax

virtual unsigned int GetMany(
    unsigned int startIndex,
    Platform::WriteOnlyArray<T>^ dest);

매개 변수Parameters

startIndexstartIndex
검색할 항목 시작 부분의 0부터 시작하는 인덱스입니다.The zero-based index of the start of the items to retrieve.

destdest
StartIndex 로 지정 된 요소에서 시작 하 여 벡터의 마지막 요소에서 끝나는 항목의, 호출자가 할당 한 배열입니다.A caller-allocated array of items that begin at the element specified by startIndex and end at the last element in the Vector.

반환 값Return Value

검색된 항목의 수입니다.The number of items retrieved.

설명Remarks

이 함수는 클라이언트 코드에서 직접 사용하지 않습니다.This function is not intended for use directly by client code. To_vector 함수 에서 내부적으로 사용 되어 Platform:: vector 인스턴스로만를 std:: vector 인스턴스로 효율적으로 변환할 수 있습니다.It is used internally in the to_vector Function to enable efficient conversion of Platform::Vector intances to std::vector instances.

Vector:: GetView 메서드Vector::GetView Method

Vector의 읽기 전용 보기, 즉 IVectorView를 반환합니다.Returns a read-only view of a Vector; that is, an IVectorView.

구문Syntax

Windows::Foundation::Collections::IVectorView<T>^ GetView();

Return ValueReturn Value

IVectorView 개체입니다.An IVectorView object.

Vector:: IndexOf 메서드Vector::IndexOf Method

현재 Vector에서 지정한 항목을 검색하고 있는 경우 항목의 인덱스를 반환합니다.Searches for the specified item in the current Vector, and if found, returns the index of the item.

구문Syntax

virtual bool IndexOf(T value, unsigned int* index);

매개 변수Parameters

valuevalue
찾을 항목입니다.The item to find.

indexindex
매개 변수 이 있는 경우 항목의 인덱스 (0부터 시작)입니다. 그렇지 않으면 0입니다.The zero-based index of the item if parameter value is found; otherwise, 0.

항목이 벡터의 첫 번째 요소 이거나 항목을 찾을 수 없는 경우에는 인덱스 매개 변수가 0입니다.The index parameter is 0 if either the item is the first element of the Vector or the item was not found. 반환 값이 이면 true 항목이 검색 되 고 첫 번째 요소 이면이 고, 그렇지 않으면 항목을 찾을 수 없습니다.If the return value is true, the item was found and it is the first element; otherwise, the item was not found.

반환 값Return Value

true 지정 된 항목이 있으면이 고, 그렇지 않으면입니다. 그렇지 않으면 false 입니다.true if the specified item is found; otherwise, false.

설명Remarks

IndexOf는 std::find_if를 사용하여 항목을 찾습니다.IndexOf uses std::find_if to find the item. 그러므로 find_if에 필요한 같음 비교를 사용하려면 사용자 지정 요소 형식이 == 및 != 연산자를 오버로드해야 합니다.Custom element types should therefore overload the == and != operator in order to enable the equality comparisons that find_if requires.

Vector:: InsertAt 메서드Vector::InsertAt Method

지정 된 항목을 지정 된 인덱스로 식별 되는 요소의 현재 Vector에 삽입 합니다.Inserts the specified item into the current Vector at the element identified by the specified index.

구문Syntax

virtual void InsertAt(unsigned int index, T item)

매개 변수Parameters

indexindex
Vector 개체의 특정 요소를 지정하는 0부터 시작하는 부호 없는 정수입니다.A zero-based, unsigned integer that specifies a particular element in the Vector object.

itemitem
인덱스로지정 된 요소에서 벡터에 삽입할 항목입니다.An item to insert into the Vector at the element specified by index. 항목 의 형식은 T 형식 이름으로 정의 됩니다.The type of item is defined by the T typename.

Vector:: RemoveAt 메서드Vector::RemoveAt Method

현재 Vector에서 지정된 인덱스로 식별되는 요소를 삭제합니다.Deletes the element identified by the specified index from the current Vector.

구문Syntax

virtual void RemoveAt(unsigned int index);

매개 변수Parameters

indexindex
Vector 개체의 특정 요소를 지정하는 0부터 시작하는 부호 없는 정수입니다.A zero-based, unsigned integer that specifies a particular element in the Vector object.

Vector:: RemoveAtEnd 메서드Vector::RemoveAtEnd Method

현재 Vector의 끝에 있는 요소를 삭제합니다.Deletes the element at the end of the current Vector.

구문Syntax

virtual void RemoveAtEnd();

Vector:: ReplaceAll 메서드Vector::ReplaceAll Method

현재 Vector에서 요소를 삭제한 다음 지정된 배열의 요소를 삽입합니다.Deletes the elements in the current Vector and then inserts the elements from the specified array.

구문Syntax

virtual void ReplaceAll(const ::Platform::Array<T>^ arr);

매개 변수Parameters

arrarr
T 형식 이름으로 정의 되는 형식의 개체 배열입니다.An array of objects whose type is defined by the T typename.

Vector:: SetAt 메서드Vector::SetAt Method

현재 Vector에서 지정된 인덱스로 식별되는 요소에 지정된 값을 할당합니다.Assigns the specified value to the element in the current Vector that is identified by the specified index.

구문Syntax

virtual void SetAt(unsigned int index, T item);

매개 변수Parameters

indexindex
Vector 개체의 특정 요소를 지정하는 0부터 시작하는 부호 없는 정수입니다.A zero-based, unsigned integer that specifies a particular element in the Vector object.

itemitem
지정된 요소에 할당할 값입니다.The value to assign to the specified element. 항목 의 형식은 T 형식 이름으로 정의 됩니다.The type of item is defined by the T typename.

Vector:: Size 메서드Vector::Size Method

현재 Vector 개체의 요소 수를 반환합니다.Returns the number of elements in the current Vector object.

구문Syntax

virtual property unsigned int Size;

Return ValueReturn Value

현재 Vector의 요소 수입니다.The number of elements in the current Vector.

Vector:: Vector 생성자Vector::Vector Constructor

Vector 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the Vector class.

구문Syntax

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);

매개 변수Parameters

a
벡터를 초기화 하는 데 사용 되는 std:: array 입니다.A std::array that will be used to initialize the Vector.

arrarr
Vector를 초기화 하는 데 사용 되는 Platform:: Array 입니다.A Platform::Array that will be used to initialize the Vector.

Cloud-initInIt
현재 Vector를 초기화하는 데 사용되는 개체 컬렉션의 형식입니다.The type of a collection of objects that is used to initialize the current Vector.

lil
Vector를 초기화 하는 데 사용 되는 T 형식의 개체의 std:: initializer_list 입니다.A std::initializer_list of objects of type T that will be used to initialize the Vector.

NN
현재 Vector를 초기화하는 데 사용되는 개체 컬렉션의 요소 수입니다.The number of elements in a collection of objects that is used to initialize the current Vector.

sizesize
Vector의 요소 수입니다.The number of elements in the Vector.

valuevalue
현재 Vector의 각 요소를 초기화하는 데 사용되는 값입니다.A value that is used to initialize each element in the current Vector.

hyper-vv
현재 Vector를 초기화 하는 데 사용 되는 std:: vector 에 대 한 Lvalues 및 rvalue 입니다.An Lvalues and Rvalues to a std::vector that is used to initialize the current Vector.

ptrptr
현재 Vector를 초기화하는 데 사용되는 std::vector에 대한 포인터입니다.Pointer to a std::vector that is used to initialize the current Vector.

firstfirst
현재 Vector를 초기화하는 데 사용되는 개체 시퀀스의 첫 번째 요소입니다.The first element in a sequence of objects that are used to initialize the current Vector. 첫 번째 형식은 완벽 한 전달을 통해 전달 됩니다.The type of first is passed by means of perfect forwarding. 자세한 내용은 RValue 참조 선언자: &&를 참조하세요.For more information, see Rvalue Reference Declarator: &&.

lastlast
현재 Vector를 초기화하는 데 사용되는 개체 시퀀스의 마지막 요소입니다.The last element in a sequence of objects that are used to initialize the current Vector. 마지막 의 형식은 완벽 한 전달방법으로 전달 됩니다.The type of last is passed by means of perfect forwarding. 자세한 내용은 RValue 참조 선언자: &&를 참조하세요.For more information, see Rvalue Reference Declarator: &&.

참고 항목See also

컬렉션 (c + +/CX)Collections (C++/CX)
Platform 네임 스페이스Platform Namespace
C++로 Windows Runtime 구성 요소 만들기Creating Windows Runtime Components in C++