다음을 통해 공유


IVector<T> 인터페이스

정의

요소의 임의 액세스 컬렉션을 나타냅니다.

.Net 이 인터페이스는 .NET 언어 프로젝션으로 인해 .NET 코드에 System.Collections.Generic.IList<T> 로 나타납니다. Windows 런타임 형식이 IVector<T>를 구현한 경우 .NET 코드는 IList<T>의 API를 대신 사용할 수 있습니다.

public interface class IVector : IIterable<T>
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(2436052969, 4513, 17221, 163, 162, 78, 127, 149, 110, 34, 45)]
template <typename T>
struct IVector : IIterable<T>
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
[Windows.Foundation.Metadata.Guid(2436052969, 4513, 17221, 163, 162, 78, 127, 149, 110, 34, 45)]
public interface IList<T> : IEnumerable<T>
Public Interface IList(Of T)
Implements IEnumerable(Of T)

형식 매개 변수

T
특성
구현

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract
Windows.Foundation.FoundationContract (v1.0에서 도입되었습니다.)

설명

.NET으로 프로그래밍할 때 이 인터페이스는 숨겨지고 개발자는 벡터/목록 형식을 구현하려는 경우 System.Collections.Generic.IList<T> 인터페이스를 사용해야 합니다. Windows 런타임 형식이 IVector<T>를 구현한 경우 .NET 코드는 IList<T>의 API를 대신 사용할 수 있습니다. 여기에는 모든 기존 Windows 런타임 API와 C# 또는 Visual Basic 앱의 Visual C++ 구성 요소 확장(C++/CX)에서 원래 구현된 Windows 런타임 구성 요소의 API 사용과 같은 시나리오도 포함됩니다.

IVector<T> 인터페이스는 인덱스로 개별적으로 액세스할 수 있는 지정된 형식의 개체 컬렉션을 나타냅니다. IVector<T> 의 속성 및 메서드는 컬렉션의 크기를 가져오고 컬렉션의 지정된 위치에서 항목을 추가 및 제거하는 등의 목록 형식 기능을 지원합니다. 또한 GetView 메서드는 관찰 가능한 상태가 변경되지 않는 벡터의 스냅샷 제공합니다. 이 스냅샷 IVector<T>를 포함하는 후속 작업에서 참조할 컬렉션의 보기가 필요한 경우에 유용합니다.

C++/WinRT 확장 함수

참고

확장 함수는 특정 Windows 런타임 API에 대한 C++/WinRT 프로젝션 형식에 있습니다. 예를 들어 winrt::Windows::Foundation::IAsyncAction은 IAsyncAction 에 대한 C++/WinRT 프로젝션 형식 입니다. 확장 함수는 실제 Windows 런타임 형식의 ABI(애플리케이션 이진 인터페이스) 화면의 일부가 아니므로 Windows 런타임 API의 멤버로 나열되지 않습니다. 그러나 C++/WinRT 프로젝트 내에서 호출할 수 있습니다. Windows 런타임 API를 확장하는 C++/WinRT 함수를 참조하세요.

auto begin() const;

범위 기반 for 루프와 같은 C++ 알고리즘에서 사용하기 위해 컬렉션의 첫 번째 요소에 대한 반복기를 반환합니다.

auto end() const;

범위 기반 for 루프와 같은 C++ 알고리즘에서 사용하기 위해 컬렉션의 마지막 요소 중 하나에 반복기를 반환합니다.

인터페이스 상속

IVector는 IIterable을 상속합니다. IVector를 구현하는 형식은 IIterable의 인터페이스 멤버도 구현합니다. 마찬가지로 .NET을 사용하는 경우 IEnumerable<T>에 대한 지원이 있습니다.

속성

Size

벡터의 항목 수를 가져옵니다.

메서드

Append(T)

항목을 벡터 끝에 추가합니다.

Clear()

벡터에서 모든 항목을 제거합니다.

GetAt(UInt32)

벡터의 지정된 인덱스에서 항목을 반환합니다.

GetMany(UInt32, T[])

지정된 인덱스에서 시작하여 벡터에서 여러 항목을 검색합니다.

C++/WinRT C++/WinRT 언어 프로젝션의 올바른 구문은 입니다 uint32_t GetMany(uint32_t startIndex, winrt::array_view<T> items);.

GetView()

벡터의 변경할 수 없는 보기를 반환합니다.

IndexOf(T, UInt32)

벡터에서 지정된 항목의 인덱스를 검색합니다.

InsertAt(UInt32, T)

벡터의 지정된 인덱스에 항목을 삽입합니다.

RemoveAt(UInt32)

벡터의 지정된 인덱스에 있는 항목을 제거합니다.

RemoveAtEnd()

벡터에서 마지막 항목을 제거합니다.

ReplaceAll(T[])

벡터의 모든 항목을 지정된 항목으로 바꿉니다.

SetAt(UInt32, T)

벡터의 지정된 인덱스에서 값을 설정합니다.

적용 대상

추가 정보