System.Generics.Collections.TDictionary

提供: RAD Studio API Documentation
移動先: 案内、 検索

System.Generics.Collections.TEnumerableSystem.TObjectTDictionary

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 プロパティは、すべてのディクショナリ エントリの一覧です。 Items プロパティにインデックスを付けることによって、値を設定したり取得することもできます。 この方法で値を設定すると、既存の値を上書きします。

クラス TObjectDictionary は TDictionary から派生しており、ディクショナリ エントリからオブジェクトを解放するための自動メカニズムを提供します。

アクセス メソッド

このセクションでは、TDictionary または TObjectDictionary を読み書きするためのメソッドがまとめられており、書き込み時の重複キーや、読み込み時のキーが見つからなかった場合の結果についても記載されています。

書き込み

メソッド インデックスの型   値の型   重複キーの場合
Add TKey TValue 例外
AddOrSetValue TKey TValue 上書き
Items TKey TValue 上書き

読み込み

メソッド インデックス/入力の型   結果の型 キーが見つからなかった場合 メモ
ContainsKey TKey Boolean False True = 見つかった
ContainsValue TValue Boolean N/A True = 見つかった
ExtractPair TKey TPair デフォルト値のペア TPair を返し、項目をディクショナリから削除
Items TKey TValue 例外 TryGetValue を使用すると例外を回避できる
operator [] TKey TValue 例外 C++ のみ
Keys N/A TKeyCollection N/A
ToArray N/A TArray<TPair<TKey,TValue>> N/A
TryGetValue TKey TValue, Boolean デフォルト値、False Items 同様だが例外は発生しない
Values N/A TValueCollection N/A

関連項目

コード サンプル

「http://docwiki.embarcadero.com/Libraries/Rio/j/index.php?title=System.Generics.Collections.TDictionary&oldid=767525」から取得