System.Generics.Collections.TDictionary
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> >
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| class | public | System.Generics.Collections.pas System.Generics.Collections.hpp |
System.Generics.Collections | System.Generics.Collections |
Beschreibung
Kollektion von Schlüssel/Wertepaaren.
TDictionary repräsentiert eine generische Kollektion von Schlüssel/Wertepaaren.
Diese Klasse stellt eine Zuordnung von einer Schlüsselkollektion zu einer Wertekollektion bereit. Wenn Sie ein TDictionary-Objekt erstellen, können Sie verschiedene Kombinationen aus Anfangskapazität, Gleichheitsoperation und Anfangsinhalt festlegen.
Sie können mit den Methoden Add oder AddOrSetValue einen Schlüssel hinzufügen, der einem entsprechenden Wert zugeordnet ist. Einträge lassen sich mit Remove oder mit der Methode Clear entfernen, die alle Schlüssel/Wertepaare löscht. Das Hinzufügen und Entfernen eines Schlüssel/Wertepaares und das Nachschlagen eines Schlüssels sind effizient (gegen O(1)), weil Schlüssel in einer Hash-Liste organisiert sind. Ein Schlüssel darf nicht nil sein (obwohl ein Wert nil sein kann), und es muss eine Gleichheitsoperation für Schlüssel vorhanden sein.
Das Vorhandensein von Schlüsseln und Werten kann mit den Methoden TryGetValue, ContainsKey und ContainsValue getestet werden.
Die Eigenschaft Items führt alle Count Dictionary-Einträge auf. Durch Indizieren der Eigenschaft Items lassen sich auch Werte setzen und abrufen. Wird ein Wert auf diese Weise gesetzt, wird ein bereits vorhandener Wert überschrieben.
Die Klasse TObjectDictionary stammt von TDictionary ab und stellt einen automatischen Mechanismus für die Freigabe von Objekten bereit, die aus Dictionary-Einträgen entfernt wurden.