System.Generics.Collections.TDictionary

Aus Appmethod Libraries
Wechseln zu: Navigation, Suche

System.Generics.Collections.TEnumerableSystem.TObjectTDictionary

Object Pascal

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

Siehe auch

Codebeispiele