表示設定
System.Generics.Collections.TDictionary
出典: XE2 API Documentation
Delphi
TDictionary<TKey,TValue> = class(TEnumerable<TPair<TKey,TValue>>)
C++
template<typename TKey, typename TValue> class PASCALIMPLEMENTATION TDictionary__2 : public TEnumerable__1<TPair__2<TKey,TValue> >
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| class | public | System.Generics.Collections.pas System.Generics.Collections.hpp |
System.Generics.Collections | System.Generics.Collections |
説明
キー-値ペアのコレクション
TDictionary は、キー-値ペアの汎用的なコレクションを表します。
このクラスは、キーのコレクションから値のコレクションへのマッピングを提供します。TDictionary オブジェクトを作成する場合は、初期の容量、等価比較演算子、および初期の内容のさまざまな組み合わせを指定できます。
Add メソッドまたは AddOrSetValue メソッドを利用して、対応する値に関連付けられたキーを追加できます。Remove メソッドまたは Clear メソッド（すべてのキー-値ペアを削除する）を利用して、エントリを削除できます。キーはハッシュ化されているため、キー-値ペアの追加や削除、およびキーの検索は効率的です（O(1) に近い）。値は nil でもかまいませんが、キーは nil であってはいけません。また、キーに対する等価比較演算子が存在しなければなりません。
TryGetValue、ContainsKey、および ContainsValue の各メソッドを利用して、キーと値が存在するかどうかをテストできます。
Items プロパティは、Count 個のすべての辞書エントリをリストします。Items プロパティにインデックスを付けることによって、値を設定したり取得することもできます。この方法で値を設定すると、既存の値が上書きされます。
TDictionary から派生した TObjectDictionary クラスは、辞書エントリから削除されたオブジェクトを自動的に解放するメカニズムを提供します。