IVector<T> インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
要素のランダム アクセス コレクションを表します。
。ネット このインターフェイスは、.NET 言語プロジェクションにより、 System.Collections.Generic.IList<T> として .NET コードに表示されます。 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 プロジェクト内から呼び出すことができます。 API を拡張する C++/WinRT 関数Windows ランタイム参照してください。
auto begin() const;
範囲ベース for のループなどの C++ アルゴリズムで使用するために、コレクションの最初の要素を指す反復子を返します。
auto end() const;
範囲ベース for のループなどの C++ アルゴリズムで使用するために、コレクションの最後の要素の 1 つ後ろの反復子を返します。
インターフェイスの継承
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) |
ベクター内の指定したインデックス位置に値を設定します。 |