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> >
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
class | public | System.Generics.Collections.pas System.Generics.Collections.hpp |
System.Generics.Collections | System.Generics.Collections |
Description
Collection de paires clé-valeur.
TDictionary représente une collection générique de paires clé-valeur.
Cette classe fournit un mappage d'une collection de clés sur une collection de valeurs. Lorsque vous créez un objet TDictionary, vous pouvez spécifier diverses combinaisons de capacité initiale, d'opération d'égalité et de contenu initial.
Vous pouvez ajouter une clé qui est associée à une valeur correspondante avec la méthode Add ou AddOrSetValue. Vous pouvez retirer des entrées avec Remove ou Clear qui retirent toutes les paires clé-valeur. L'ajout ou la suppression d'une paire clé-valeur et la recherche d'une clé sont performantes, proches de O(1), car les clés sont hachées. Une clé ne doit pas être à nil (bien qu'une valeur puisse être à nil) et il doit y avoir une opération de comparaison d'égalité pour les clés.
Vous pouvez tester la présence de clés ou de valeurs avec les méthodes TryGetValue, ContainsKey et ContainsValue.
La propriété Items liste toutes les entrées de dictionnaire Count. Vous pouvez aussi définir et obtenir les valeurs en indexant la propriété Items. Définir la valeur de cette façon redéfinit toute valeur existante.
La classe TObjectDictionary hérite de TDictionary et fournit un mécanisme automatique de libération des objets retirés des entrées du dictionnaire.
Méthodes d'accès
Cette section récapitule les méthodes relatives à la lecture et l'écriture de TDictionary ou TObjectDictionary, y compris l'effet des clés dupliquées lors de l'écriture ou la clé non trouvée lors de la lecture.
Ecriture
Méthode | Type d'index | Type de valeur | En cas de clé dupliquée |
---|---|---|---|
Add | TKey | TValue | Exception |
AddOrSetValue | TKey | TValue | Ecrasement |
Items | TKey | TValue | Ecrasement |
Lecture
Méthode | Type d'index/type d'entrée | Type de résultat | Si la clé n'est pas trouvée | Remarques |
---|---|---|---|---|
ContainsKey | TKey | Booléen | false | True = trouvée |
ContainsValue | TValue | Booléen | n/d | True = trouvée |
ExtractPair | TKey | TPair | Paire par défaut | Renvoie TPair, retire l'élément du dictionnaire |
Items | TKey | TValue | Exception | Utilisez TryGetValue pour éviter l'exception |
operator [] | TKey | TValue | Exc | C++ uniquement |
Keys | n/d | TKeyCollection | n/d | |
ToArray | n/d | TArray<TPair<TKey,TValue>> | n/d | |
TValue, booléen | default,false | Comme Items[] sans exception | ||
Values | n/d | TValueCollection | n/d |
Voir aussi
- Data.DBXCommon.TKey
- System.Rtti.TValue
- System.Generics.Collections.TDictionary.TKeyCollection
- System.Generics.Collections.TDictionary.TValueCollection
- TObjectDictionary