System.Generics.Collections.TDictionary

Übergeordnet: System.Generics.Collections
Methoden
Eigenschaften
Ereignisse
Typen

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> >

Inhaltsverzeichnis

1 Eigenschaften
2 Beschreibung

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. Beim Erstellen eines TDictionary-Objekts können Sie verschiedene Kombinationen aus Anfangskapazität, Gleichheitsoperation und Anfangsinhalt festlegen.

Mit den Methoden Add und AddOrSetValue können Sie einen Schlüssel hinzufügen, der einem entsprechenden Wert zugeordnet ist. Mit der Methode Remove oder der Methode Clear, die alle Schlüssel/Wertepaare entfernt, können Sie Einträge entfernen. 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.

Mit den Methoden TryGetValue, ContainsKey und ContainsValue können Sie testen, ob Schlüssel und Werte vorhanden sind.

Die Eigenschaft Items führt alle Count Dictionary-Einträge auf. Werte können auch durch Indizierung der Eigenschaft Items gesetzt und abgerufen werden. 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.

Zugriffsmethoden

Dieser Abschnitt enthält eine Übersicht über die Methoden zum Lesen und Schreiben von TDictionary oder TObjectDictionary, einschließlich der Auswirkung von doppelten Schlüsseln beim Schreiben oder des Nicht-Findens von Schlüsseln beim Lesen.

Schreiben

Methode	Indextyp	Werttyp	Bei doppeltem Schlüssel
Add	TKey	TValue	Exception
AddOrSetValue	TKey	TValue	Überschreiben
Items	TKey	TValue	Überschreiben

Lesen

Methode	Index/Eingabetyp	Ergebnistyp	Bei Schlüssel nicht gefunden	Bemerkungen
ContainsKey	TKey	Boolean	false	True = gefunden
ContainsValue	TValue	Boolean	n/v	True = gefunden
ExtractPair	TKey	TPair	Standardpaar	Gibt TPair zurück, entfernt den Eintrag aus dem Dictionary
Items	TKey	TValue	Exception	Verwenden Sie TryGetValue, um eine Exception zu vermeiden
operator []	TKey	TValue	Exc	Nur C++
Keys	n/v	TKeyCollection	n/v
ToArray	n/v	TArray<TPair<TKey,TValue>>	n/v
TValue, Boolean	default, false	Wie Items[] ohne Exception
Values	n/v	TValueCollection	n/v