IVector<T> 인터페이스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
요소의 임의 액세스 컬렉션을 나타냅니다.
.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[]) |
지정된 인덱스에서 시작하여 벡터에서 여러 항목을 검색합니다.
|
| GetView() |
벡터의 변경할 수 없는 보기를 반환합니다. |
| IndexOf(T, UInt32) |
벡터에서 지정된 항목의 인덱스를 검색합니다. |
| InsertAt(UInt32, T) |
벡터의 지정된 인덱스에 항목을 삽입합니다. |
| RemoveAt(UInt32) |
벡터의 지정된 인덱스에 있는 항목을 제거합니다. |
| RemoveAtEnd() |
벡터에서 마지막 항목을 제거합니다. |
| ReplaceAll(T[]) |
벡터의 모든 항목을 지정된 항목으로 바꿉니다. |
| SetAt(UInt32, T) |
벡터의 지정된 인덱스에서 값을 설정합니다. |