Delphi Generics.Collections

Transcription

Delphi Generics.Collections
Delphi Generics.Collections
Copyright© 2008 Embarcadero Technologies, Inc. Tous droits réservés.
Delphi Generics.Collections
Sommaire
Generics.Collections.TCollectionNotification
1
Generics.Collections.TCollectionNotifyEvent
3
Generics.Collections.TDictionary
5
Generics.Collections.TDictionary.Add
7
Generics.Collections.TDictionary.AddOrSetValue
9
Generics.Collections.TDictionary.Clear
11
Generics.Collections.TDictionary.ContainsKey
13
Generics.Collections.TDictionary.ContainsValue
15
Generics.Collections.TDictionary.Count
17
Generics.Collections.TDictionary.Create
19
Generics.Collections.TDictionary.Destroy
21
Generics.Collections.TDictionary.Items
23
Generics.Collections.TDictionary.OnKeyNotify
25
Generics.Collections.TDictionary.OnValueNotify
27
Generics.Collections.TDictionary.Remove
29
Generics.Collections.TDictionary.TrimExcess
31
iii
Delphi Generics.Collections
iv
Generics.Collections.TDictionary.TryGetValue
33
Generics.Collections.TDictionaryOwnerships
35
Generics.Collections.TList
37
Generics.Collections.TList.Add
39
Generics.Collections.TList.AddRange
41
Generics.Collections.TList.BinarySearch
43
Generics.Collections.TList.Capacity
45
Generics.Collections.TList.Clear
47
Generics.Collections.TList.Contains
49
Generics.Collections.TList.Count
51
Generics.Collections.TList.Create
53
Generics.Collections.TList.Delete
55
Generics.Collections.TList.DeleteRange
57
Generics.Collections.TList.Destroy
59
Generics.Collections.TList.Extract
61
Generics.Collections.TList.IndexOf
63
Generics.Collections.TList.Insert
65
Delphi Generics.Collections
Generics.Collections.TList.InsertRange
67
Generics.Collections.TList.Items
69
Generics.Collections.TList.LastIndexOf
71
Generics.Collections.TList.OnNotify
73
Generics.Collections.TList.Remove
75
Generics.Collections.TList.Reverse
77
Generics.Collections.TList.Sort
79
Generics.Collections.TList.TrimExcess
81
Generics.Collections.TObjectDictionary
83
Generics.Collections.TObjectDictionary.Create
85
Generics.Collections.TObjectList
87
Generics.Collections.TObjectList.Create
89
Generics.Collections.TObjectList.OwnsObjects
91
Generics.Collections.TObjectQueue
93
Generics.Collections.TObjectQueue.Create
95
Generics.Collections.TObjectQueue.Dequeue
97
Generics.Collections.TObjectQueue.OwnsObjects
99
v
Delphi Generics.Collections
vi
Generics.Collections.TObjectStack
101
Generics.Collections.TObjectStack.Create
103
Generics.Collections.TObjectStack.OwnsObjects
105
Generics.Collections.TObjectStack.Pop
107
Generics.Collections.TQueue
109
Generics.Collections.TQueue.Clear
111
Generics.Collections.TQueue.Count
113
Generics.Collections.TQueue.Create
115
Generics.Collections.TQueue.Dequeue
117
Generics.Collections.TQueue.Destroy
119
Generics.Collections.TQueue.Enqueue
121
Generics.Collections.TQueue.Extract
123
Generics.Collections.TQueue.OnNotify
125
Generics.Collections.TQueue.Peek
127
Generics.Collections.TQueue.TrimExcess
129
Generics.Collections.TStack
131
Generics.Collections.TStack.Clear
133
Delphi Generics.Collections
Generics.Collections.TStack.Count
135
Generics.Collections.TStack.Create
137
Generics.Collections.TStack.Destroy
139
Generics.Collections.TStack.Extract
141
Generics.Collections.TStack.OnNotify
143
Generics.Collections.TStack.Peek
145
Generics.Collections.TStack.Pop
147
Generics.Collections.TStack.Push
149
Generics.Collections.TStack.TrimExcess
151
Generics.Collections
153
Index
a
vii
1
Delphi Generics.Collections
1
Generics.Collections.TCollectionNotificati
on
Type du changement apporté à la collection pour l'événement OnNotify.
Description
Le tableau suivant liste les valeurs de TCollectionNotification.
Valeur
Signification
cnAdded
Elément ajouté à la collection.
cnRemoved
Elément retiré de la collection.
cnExtracted
Elément extrait de la collection, c'est-à-dire retiré et sa valeur
renvoyée.
Voir aussi
OnNotify (
see page 73)
OnNotify (
see page 125)
OnNotify (
see page 143)
TCollectionNotifyEvent (
see page 3)
1
2
Delphi Generics.Collections
2
Generics.Collections.TCollectionNotifyEv
ent
Gestionnaire d'événement pour l'événement OnNotify.
Description
TCollectionNotifyEvent est un gestionnaire d'événement qui peut être défini pour un événement OnNotify. Cette routine est
appelée lorsque la collection a été modifiée.
Sender est l'objet collection affecté par l'événement. Item est un élément qui a été modifié dans la collection. Action est un
TCollectionNotification qui indique le type du changement.
Voir aussi
OnNotify (
see page 73)
OnNotify (
see page 125)
OnNotify (
see page 143)
TCollectionNotification (
see page 1)
3
3
Delphi Generics.Collections
3 Generics.Collections.TDictionary
Collection de paires clé-valeur.
Description
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 la méthode Remove ou Clear qui retire toutes les paires clé-valeur. L'ajout ou la suppression
d'une paire clé-valeur et la recherche d'une clé sont performantes, proche de O(1), car les clés sont hachées. Une clé ne doit
pas être à nil (bien qu'une valeur peut ê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 Count entrées du dictionnaire. 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.
Voir aussi
TObjectDictionary (
see page 83)
Count (
see page 17)
Items (
see page 23)
Add (
see page 7)
AddOrSetValue (
Clear (
see page 9)
see page 11)
ContainsKey (
ContainsValue (
Remove (
see page 13)
see page 15)
see page 29)
5
Delphi Generics.Collections
TryGetValue (
6
see page 33)
3
4
Delphi Generics.Collections
4 Generics.Collections.TDictionary.Add
Ajoute une paire clé-valeur.
Description
Add ajoute une clé et sa valeur correspondante dans le dictionnaire. La clé ne peut pas être nil, mais la valeur le peut.
Si la clé existe déjà dans le dictionnaire, une exception est déclenchée.
Un événement OnNotify survient en indiquant qu'une entrée a été ajoutée au dictionnaire.
La propriété Items liste toutes les entrées du dictionnaire. Vous pouvez aussi définir et obtenir des valeurs en indexant
directement la propriété Items. Par exemple, vous pouvez définir une valeur de la façon suivante :
Items[clé] := valeur;
Définir la valeur de cette façon redéfinit la valeur d'une clé existante, mais ne déclenche pas une exception.
Voir aussi
Items (
see page 23)
AddOrSetValue (
see page 9)
OnNotify
7
5
Delphi Generics.Collections
5
Generics.Collections.TDictionary.AddOrS
etValue
Ajoute une paire clé-valeur quand la clé existe déjà.
Description
AddOrSetValue ajoute une paire clé-valeur à un dictionnaire même si la clé existe déjà. La clé ne peut pas être nil, mais la
valeur le peut. Cette méthode vérifie si la clé existe dans le dictionnaire. Dans ce cas, elle est équivalente à Items[clé] :=
valeur;. Sinon, elle est équivalente à Add(clé, valeur);.
Un événement OnNotify survient en indiquant qu'une entrée a été ajoutée au dictionnaire.
Voir aussi
Items (
Add (
see page 23)
see page 7)
OnNotify
9
6
Delphi Generics.Collections
6 Generics.Collections.TDictionary.Clear
Efface toutes les données.
Description
Clear retire toutes les clés et valeurs du dictionnaire. La propriété Count est définie sur 0. La capacité est aussi définie sur 0.
C'est une opération O(n), où n est égal à Count, le nombre d'entrées du dictionnaire.
Remarque: Clear ne libère pas les éléments au fur et à mesure qu'ils sont retirés. Si vous avez besoin de les libérer, utilisez
l'événement OnNotify, qui survient pour chaque entrée retirée et fournit les éléments retirés.
Voir aussi
Count (
see page 17)
Remove (
see page 29)
TrimExcess (
see page 31)
OnNotify
11
7
Delphi Generics.Collections
7
Generics.Collections.TDictionary.Contain
sKey
Teste la présence d'une clé dans le dictionnaire.
Description
ContainsKey renvoie true si la clé donnée est présente dans le dictionnaire, et false sinon. C'est une opération O(1).
Voir aussi
AddOrSetValue (
see page 9)
ContainsValue (
see page 15)
TryGetValue (
see page 33)
13
8
Delphi Generics.Collections
8
Generics.Collections.TDictionary.Contain
sValue
Vérifie la présence d'une valeur dans le dictionnaire.
Description
ContainsValue renvoie true si la valeur donnée est présente dans le dictionnaire, et false sinon. C'est une opération O(n), où n
est le nombre d'entrées dans la propriété Count.
Voir aussi
Count (
see page 17)
ContainsKey (
see page 13)
15
9
Delphi Generics.Collections
9 Generics.Collections.TDictionary.Count
Nombre d'entrées.
Description
Count contient le nombre de paires clé-valeur du dictionnaire. La propriété Items contient Count entrées.
Voir aussi
Items (
see page 23)
17
10
Delphi Generics.Collections
10
Generics.Collections.TDictionary.Create
Crée un dictionnaire.
Description
Cette méthode surchargée crée et initialise une instance de dictionnaire. Diverses combinaisons de paramètres peuvent être
utilisées pour spécifier la capacité initiale ACapacity, une fonction de comparaison d'égalité AComparer ou une collection
initiale d'éléments clé-valeur Collection.
Voir aussi
Destroy (
see page 21)
19
11
Delphi Generics.Collections
11
Generics.Collections.TDictionary.Destroy
Détruit un dictionnaire.
Description
Cette méthode détruit une instance d'un dictionnaire en utilisant Clear.
Remarque: Clear ne libère pas les éléments au fur et à mesure qu'ils sont retirés. Si vous avez besoin de les libérer, utilisez
l'événement OnNotify, qui survient pour chaque entrée retirée et fournit les éléments retirés.
Voir aussi
Clear (
Create (
see page 11)
see page 19)
21
12
Delphi Generics.Collections
12
Generics.Collections.TDictionary.Items
Liste indexable de toutes les entrées du dictionnaire.
Description
Items est une liste indexable de toutes les paires clé-valeur du dictionnaire.
La propriété Count contient le nombre d'entrées de dictionnaire de Items.
Vous pouvez définir et obtenir les valeurs en indexant directement la propriété Items. Définir la valeur de cette façon redéfinit
une valeur existante, et ne déclenche pas une exception.
Voir aussi
Count (
Add (
see page 17)
see page 7)
AddOrSetValue (
see page 9)
23
13
Delphi Generics.Collections
13
Generics.Collections.TDictionary.OnKeyN
otify
Survient quand une paire de clés du dictionnaire est modifiée.
Description
Pascal
property OnNotify: TCollectionNotifyEvent<TKey>;
C++
__property _decl_TCollectionNotifyEvent__1(TKey, OnKeyNotify);
L'événement OnKeyNotify survient quand des éléments sont ajoutés ou retirés du dictionnaire. Plusieurs événements peuvent
survenir pour une opération unique. Cela permet la libération des objets retirés.
Voir aussi
Add (
see page 7)
AddOrSetValue (
Clear (
see page 9)
see page 11)
Remove (
see page 29)
TCollectionNotifyEvent (
see page 3)
TCollectionNotification (
see page 1)
25
14
Delphi Generics.Collections
14
Generics.Collections.TDictionary.OnValue
Notify
Survient quand une paire de clés du dictionnaire est modifiée.
Description
Pascal
property OnNotify: TCollectionNotifyEvent<TValue>;
C++
__property _decl_TCollectionNotifyEvent__1(TValue, OnValueNotify);
L'événement OnValueNotify survient quand des éléments sont ajoutés ou retirés du dictionnaire. Plusieurs événements peuvent
survenir pour une opération unique. Cela permet la libération des objets retirés.
Voir aussi
Add (
see page 7)
AddOrSetValue (
Clear (
see page 9)
see page 11)
Remove (
see page 29)
TCollectionNotifyEvent (
see page 3)
TCollectionNotification (
see page 1)
27
15
Delphi Generics.Collections
15
Generics.Collections.TDictionary.Remove
Retire une paire clé-valeur.
Description
Remove retire la clé donnée et sa valeur associée du dictionnaire. Aucune exception n'est déclenchée si la clé n'est pas
présente dans le dictionnaire. C'est une opération O(1).
Un événement OnNotify survient en indiquant qu'une entrée a été retirée du dictionnaire.
Voir aussi
Destroy (
Clear (
see page 21)
see page 11)
TrimExcess (
see page 31)
OnNotify
29
16
Delphi Generics.Collections
16
Generics.Collections.TDictionary.TrimExc
ess
Réduit la capacité au nombre en cours des entrées.
Description
TrimExcess change la capacité par le nombre d'entrées du dictionnaire, contenu dans Count.
Cette méthode réorganise la table de hachage interne afin de gagner de l'espace. Cela n'est utile qu'après la suppression d'un
nombre important d'éléments dans le dictionnaire.
Voir aussi
Count (
see page 17)
Remove (
Clear (
see page 29)
see page 11)
TrimExcess (
see page 81)
TrimExcess (
see page 129)
TrimExcess (
see page 151)
31
17
Delphi Generics.Collections
17
Generics.Collections.TDictionary.TryGetV
alue
Tente d'obtenir la valeur de la clé.
Description
TryGetValue renvoie true si la clé donnée est présente dans le dictionnaire et fournit sa valeur dans Value. Sinon, elle renvoie
false et Value est défini sur le type de valeur par défaut TValue. Aucune exception n'est déclenchée si la clé n'est pas présente
dans le dictionnaire. C'est une opération O(1).
Voir aussi
ContainsKey (
see page 13)
33
18
Delphi Generics.Collections
18
Generics.Collections.TDictionaryOwnersh
ips
Ensemble des possessions pour TObjectDictionary.
Description
TDictionaryOwnerships est un ensemble de possessions pour les objets TObjectDictionary spécifiées à la création de l'objet.
Aucune (clé/valeur), une ou les deux peuvent être spécifiées. Si le dictionnaire possède la clé et/ou la valeur, celle-ci est libérée
quand l'entrée est retirée du dictionnaire.
Le tableau suivant liste les valeurs de TDictionaryOwnerships.
Valeur
Signification
doOwnsKeys
Le dictionnaire possède les clés des entrées.
doOwnsValues
Le dictionnaire possède les valeurs des entrées.
Voir aussi
Create (
see page 85)
35
19
Delphi Generics.Collections
19 Generics.Collections.TList
Liste ordonnée.
Description
TList représente une liste ordonnée, accessible par un index.
Vous pouvez créer une liste avec une collection d'éléments spécifique et un opérateur de comparaison.
Vous pouvez ajouter, modifier, insérer et retirer un élément d'une liste, ou effacer la liste entière. Vous pouvez ajouter des objets
nil dans la liste.
Vous pouvez trier, effectuer une recherche et inverser une liste.
Count contient le nombre d'éléments de la liste. Capacity représente le nombre d'éléments que la liste peut contenir avant d'être
redimensionnée. Vous pouvez aussi définir et obtenir les valeurs en indexant le tableau Items.
Un événement OnNotify vous indique quand la liste a été modifiée.
La classe TObjectList hérite de TList et fournit un mécanisme automatique de libération des objets retirés des listes.
Voir aussi
TObjectList (
Capacity (
see page 87)
see page 45)
Count (
see page 51)
Items (
see page 69)
Add (
see page 39)
AddRange (
see page 41)
BinarySearch (
Clear (
see page 43)
see page 47)
Create (
see page 53)
Delete (
see page 55)
DeleteRange (
see page 57)
37
Delphi Generics.Collections
IndexOf (
Insert (
see page 63)
see page 65)
InsertRange (
Remove (
see page 75)
Reverse (
see page 77)
Sort (
see page 79)
OnNotify (
38
see page 67)
see page 73)
19
20
Delphi Generics.Collections
20 Generics.Collections.TList.Add
Ajoute un élément à la fin de la liste.
Description
Add ajoute un élément donné à la fin de la liste. Vous pouvez ajouter nil. La capacité de la liste, Capacity, est augmentée si
nécessaire. C'est une opération O(1).
Un événement OnNotify survient en indiquant qu'une entrée a été ajoutée à la liste.
Voir aussi
Capacity (
AddRange (
OnNotify (
see page 45)
see page 41)
see page 73)
39
21
Delphi Generics.Collections
21 Generics.Collections.TList.AddRange
Ajoute une collection à la fin de la liste.
Description
AddRange ajoute une collection d'éléments à la fin de la liste. La capacité de la liste, Capacity, est augmentée si nécessaire.
C'est une opération O(n), où n est le nombre d'éléments de la collection ajoutée.
Un événement OnNotify survient en indiquant que des entrées ont été ajoutées à la liste.
Voir aussi
Capacity (
Add (
see page 45)
see page 39)
InsertRange (
OnNotify (
see page 67)
see page 73)
41
22
Delphi Generics.Collections
22
Generics.Collections.TList.BinarySearch
Recherche un élément dans une liste triée en utilisant une recherche binaire.
Description
La méthode surchargée BinarySearch recherche l'élément de liste Item en utilisant une recherche binaire. La méthode renvoie
true si elle trouve l'élément, et false sinon. En cas de recherche fructueuse, Index contient l'index de base zéro de l'élément
Item. En cas de recherche infructueuse, Index contient l'index de la première entrée supérieure à Item.
Remarque: BinarySearch nécessite que la liste soit triée. La méthode IndexOf ne nécessite pas une liste triée, mais est
généralement plus lente que BinarySearch.
Si plusieurs éléments de la liste correspondent à Item, l'index de la première occurrence est renvoyé dans Index. Il s'agit de
l'index d'un des éléments correspondants, pas nécessairement le premier.
La fonction de comparaison AComparer peut être fournie pour comparer les éléments.
Si Item est hors de la portée de la liste, une exception EArgumentOutOfRangeException est déclenchée.
C'est une opération O(n) pour une liste avec n entrées.
Voir aussi
IndexOf (
Sort (
see page 63)
see page 79)
43
23
Delphi Generics.Collections
23 Generics.Collections.TList.Capacity
Capacité d'une liste.
Description
Capacity obtient ou définit la capacité d'une liste, qui est la taille maximale de la liste sans redimensionnement. La capacité ne
peut pas être définie sur une valeur inférieure à Count, le nombre réel des éléments de la liste.
La méthode TrimExcess réduit la capacité de la liste à son nombre en cours d'éléments, Count.
Voir aussi
Count (
see page 51)
Items (
see page 69)
TrimExcess (
see page 81)
45
24
Delphi Generics.Collections
24 Generics.Collections.TList.Clear
Retire toutes les entrées d'une liste.
Description
Clear retire toutes les entrées d'une liste. C'est une opération O(1). Les propriétés Capacity et Count sont définies sur 0.
Remarque: Clear ne libère pas les éléments au fur et à mesure qu'ils sont retirés. Si vous avez besoin de les libérer, utilisez
l'événement OnNotify, qui survient pour chaque élément retiré et fournit l'élément retiré.
Voir aussi
Capacity (
Count (
see page 45)
see page 51)
Remove (
see page 75)
OnNotify (
see page 73)
47
25
Delphi Generics.Collections
25 Generics.Collections.TList.Contains
Teste la présence d'un élément dans une liste.
Description
Contains renvoie true si l'élément Value est présent dans la liste, et false sinon. Cette méthode indique seulement si l'élément
est ou n'est pas dans la liste. Utilisez IndexOf pour obtenir l'index d'un élément d'une liste.
Puisque la recherche de l'élément est linéaire, c'est une opération O(n) pour une liste avec n entrées.
Voir aussi
IndexOf (
see page 63)
49
26
Delphi Generics.Collections
26 Generics.Collections.TList.Count
Nombre d'éléments d'une liste.
Description
Count obtient ou définit le nombre réel des éléments d'une liste. Count est toujours inférieure ou égale à Capacity.
Si une opération, comme Insert, augmente Count en obtenant une valeur supérieure à Capacity, la liste est automatiquement
redimensionnée et Capacity est augmentée.
Si Count est réduit, alors Count - Value éléments sont retirés à la fin de la liste.
Voir aussi
Capacity (
see page 45)
Items (
see page 69)
Insert (
see page 65)
51
27
Delphi Generics.Collections
27 Generics.Collections.TList.Create
Crée et initialise une instance de liste.
Description
Cette méthode surchargée crée et initialise une instance de liste.
AComparer est une fonction de comparaison. Si elle n'est pas fournie, le comparateur par défaut du type est utilisé.
Collection est une collection permettant d'initialiser la liste. Les objets sont ajoutés dans l'ordre de la Collection. Si la
Collection est spécifiée, la création est une opération O(n), où n est le nombre d'éléments de la Collection.
Voir aussi
Destroy (
see page 59)
InsertRange (
see page 67)
53
28
Delphi Generics.Collections
28 Generics.Collections.TList.Delete
Retire l'entrée située à l'index donné.
Description
Delete retire l'entrée de liste située à l'index spécifié par Index.
Si Index n'est pas valide pour la liste, une exception EArgumentOutOfRangeException est déclenchée.
Un événement OnNotify survient en indiquant qu'une entrée a été retirée de la liste.
Voir aussi
Clear (
see page 47)
DeleteRange (
Extract (
Insert (
see page 57)
see page 61)
see page 65)
InsertRange (
see page 67)
Remove (
see page 75)
OnNotify (
see page 73)
55
29
Delphi Generics.Collections
29
Generics.Collections.TList.DeleteRange
Retire plusieurs entrées à partir de l'index donné.
Description
DeleteRange retire ACount entrées de liste à partir de l'index spécifié par AIndex.
Si AIndex et ACount décrivent une étendue incorrecte pour la liste, une exception EArgumentOutOfRangeException est
déclenchée.
C'est une opération O(ACount).
Un événement OnNotify survient en indiquant que les entrées ont été retirées de la liste.
Voir aussi
Clear (
see page 47)
Delete (
Insert (
see page 55)
see page 65)
InsertRange (
see page 67)
Remove (
see page 75)
OnNotify (
see page 73)
57
30
Delphi Generics.Collections
30 Generics.Collections.TList.Destroy
Détruit une liste.
Description
Cette méthode détruit une liste.
Voir aussi
Create (
see page 53)
59
31
Delphi Generics.Collections
31 Generics.Collections.TList.Extract
Retire et renvoie une entrée d'une liste.
Description
Extract retire l'entrée Value de la liste, en renvoyant cette valeur. Si Value n'est pas dans la liste, elle renvoie la valeur par
défaut de son type T.
Un événement OnNotify survient en indiquant qu'une entrée a été retirée de la liste. La méthode Extract est similaire à la
méthode Remove à l'exception du code d'événement indiquant qu'un élément a été extrait plutôt que retiré, et elle est fournie
afin que les éléments puissent être retirés sans libération.
Voir aussi
Clear (
see page 47)
Delete (
see page 55)
DeleteRange (
see page 57)
Remove (
see page 75)
OnNotify (
see page 73)
61
32
Delphi Generics.Collections
32 Generics.Collections.TList.IndexOf
Recherche un élément en utilisant une recherche linéaire.
Description
IndexOf recherche l'élément de liste Value en utilisant une recherche linéaire. La méthode renvoie l'index de base zéro de la
première entrée égale à Value. En cas de recherche infructueuse, elle renvoie -1.
Puisque la recherche est linéaire, c'est une opération O(n) pour une liste avec n entrées. La méthode BinarySearch est
généralement plus rapide, mais elle nécessite une liste triée.
Voir aussi
BinarySearch (
Contains (
see page 43)
see page 49)
LastIndexOf (
see page 71)
63
33
Delphi Generics.Collections
33 Generics.Collections.TList.Insert
Insère une entrée dans une liste.
Description
Insert insère un élément Value dans la liste à l'index spécifié par Index. Si la valeur Count de la liste est déjà égale à Capacity,
Capacity est augmentée.
Si Index n'est pas valide pour la liste, une exception EArgumentOutOfRangeException est déclenchée.
C'est une opération O(n), où n est le nombre d'éléments de la liste.
Un événement OnNotify survient en indiquant qu'un élément a été inséré dans la liste.
Voir aussi
Count (
see page 51)
Capacity (
Delete (
see page 45)
see page 55)
DeleteRange (
Extract (
see page 57)
see page 61)
InsertRange (
see page 67)
Remove (
see page 75)
OnNotify (
see page 73)
65
34
Delphi Generics.Collections
34
Generics.Collections.TList.InsertRange
Insère une collection dans une liste.
Description
InsertRange insère un tableau de valeurs Values dans la liste à l'index spécifié par Index. Si la valeur Count de la liste plus les
entrées supplémentaires est supérieure à Capacity, Capacity est augmentée.
Si Index n'est pas valide pour la liste, une exception EArgumentOutOfRangeException est déclenchée.
C'est une opération O(n + m), où n est le nombre d'éléments de la liste et m est le nombre d'entrées de Values.
Un événement OnNotify survient en indiquant que les éléments ont été insérés dans la liste.
Voir aussi
Count (
see page 51)
Capacity (
Delete (
see page 45)
see page 55)
DeleteRange (
Extract (
see page 57)
see page 61)
InsertRange
Remove (
see page 75)
OnNotify (
see page 73)
67
35
Delphi Generics.Collections
35 Generics.Collections.TList.Items
Elément à l'index spécifié.
Description
Items obtient ou définit l'élément de la liste situé à l'index spécifié.
Vous pouvez utiliser Items pour obtenir et définir des valeurs de liste par index en utilisant la syntaxe myList[i] pour accéder
au iième élément de la liste.
Voir aussi
Capacity (
Count (
see page 45)
see page 51)
69
36
Delphi Generics.Collections
36
Generics.Collections.TList.LastIndexOf
Obtient l'index de la dernière instance d'une entrée.
Description
LastIndexOf obtient l'index de base zéro de la dernière instance de Value dans la liste. En cas de recherche infructueuse, la
fonction renvoie -1.
Puisque la recherche est linéaire, c'est une opération O(n) pour une liste avec n entrées.
Voir aussi
IndexOf (
see page 63)
71
37
Delphi Generics.Collections
37 Generics.Collections.TList.OnNotify
Se produit quand la liste est modifiée.
Description
L'événement OnNotify survient quand des éléments sont ajoutés ou retirés de la liste. Plusieurs événements peuvent se
produire pour une seule opération. Cela permet la libération des objets retirés.
Voir aussi
Add (
see page 39)
AddRange (
Delete (
see page 41)
see page 55)
DeleteRange (
Insert (
see page 57)
see page 65)
InsertRange (
see page 67)
Remove (
see page 75)
OnNotify (
see page 125)
OnNotify (
see page 143)
TCollectionNotifyEvent (
see page 3)
TCollectionNotification (
see page 1)
73
38
Delphi Generics.Collections
38 Generics.Collections.TList.Remove
Retire la première occurrence d'une valeur.
Description
Remove retire la première instance de Value dans la liste, en renvoyant son index de base zéro. Si Value n'est pas dans la liste,
cette fonction renvoie -1.
Puisque la recherche est linéaire, c'est une opération O(n) pour une liste avec n entrées.
Un événement OnNotify survient en indiquant qu'une entrée a été retirée de la liste.
Voir aussi
Clear (
see page 47)
Delete (
see page 55)
DeleteRange (
Extract (
IndexOf (
OnNotify (
see page 57)
see page 61)
see page 63)
see page 73)
75
39
Delphi Generics.Collections
39 Generics.Collections.TList.Reverse
Inverse l'ordre d'une liste.
Description
Cette méthode inverse l'ordre de tous les éléments d'une liste.
C'est une opération O(n), où n est le nombre d'éléments de la liste.
Voir aussi
Sort (
see page 79)
77
40
Delphi Generics.Collections
40 Generics.Collections.TList.Sort
Trie une liste.
Description
Cette méthode trie une liste. Si AComparer est fourni, il est utilisé pour comparer les éléments. Sinon, le comparateur par
défaut des éléments de liste est utilisé.
Ce tri est une opération O(n log n), où n est le nombre d'éléments de la liste. Un algorithme QuickSort est utilisé. Ainsi, l'ordre
des éléments égaux peut ne pas être préservé.
Voir aussi
BinarySearch (
Reverse (
see page 43)
see page 77)
79
41
Delphi Generics.Collections
41 Generics.Collections.TList.TrimExcess
Définit la capacité de la liste sur le nombre d'éléments de la liste.
Description
TrimExcess définit Capacity sur Count, en perdant la capacité excédentaire de la liste.
Voir aussi
Count (
see page 51)
Capacity (
Clear (
see page 45)
see page 47)
TrimExcess (
see page 31)
TrimExcess (
see page 129)
TrimExcess (
see page 151)
81
42
Delphi Generics.Collections
42
Generics.Collections.TObjectDictionary
Collection des paires clé-valeur des objets.
Description
TObjectDictionary représente une collection générique des paires clé-valeur des objets.
TObjectDictionary est un TDictionary avec la fonctionnalité de libération automatique des objets quand ils sont retirés du
dictionnaire. Quand un TObjectDictionary est instancié, un paramètre Ownerships indique si le dictionnaire possède les clés
et/ou les valeurs. Si la clé et/ou la valeur est possédée par le dictionnaire, quand l'entrée est retirée, la clé et/ou la valeur est
libérée.
Voir aussi
TDictionary (
Create (
see page 5)
see page 85)
83
43
Delphi Generics.Collections
43
Generics.Collections.TObjectDictionary.Cr
eate
Crée une instance de TObjectDictionary.
Description
Cette méthode surchargée crée une instance de TObjectDictionary.
Le paramètre Ownerships est un TDictionaryOwnerships qui indique que les clés et/ou les valeurs des entrées sont possédées
par le dictionnaire. La clé ou la valeur, ou les deux, peuvent être possédés par le dictionnaire. Si l'objet est possédé, l'entrée est
alors retirée du dictionnaire, la clé et/ou la valeur est libérée.
ACapacity est la capacité initiale du dictionnaire.
AComparer est une fonction de comparaison d'égalité. Si elle n'est pas fournie, le comparateur par défaut du type est utilisé.
Voir aussi
TDictionaryOwnerships (
Create (
see page 35)
see page 19)
85
44
Delphi Generics.Collections
44 Generics.Collections.TObjectList
Liste ordonnée d'objets.
Description
TObjectList représente une liste ordonnée d'objets, accessible par un index.
TObjectList est un TList avec la fonctionnalité de libération automatique des entrées d'objet quand elles sont retirées de la liste.
Quand un TObjectList est instancié, un paramètre AOwnsObjects indique si la liste possède les entrées de liste. Si l'entrée est
possédée, quand l'objet de l'entrée est retiré de la liste, il est libéré.
La propriété OwnsObjects obtient ou définit la possession des objets.
Voir aussi
OwnsObjects (
Create (
see page 91)
see page 89)
87
45
Delphi Generics.Collections
45
Generics.Collections.TObjectList.Create
Crée une instance de TObjectList.
Description
Cette méthode surchargée crée une instance de TObjectList.
Le paramètre AOwnsObjects est un booléen qui indique si les entrées d'objet sont possédées par la liste. Si l'objet est
possédé, quand l'entrée est retirée de la liste, l'objet est libéré. La propriété OwnsObjects est définie à partir de la valeur de ce
paramètre. La valeur par défaut est true.
Collection est une collection permettant d'initialiser la liste. Les objets sont ajoutés dans l'ordre de la Collection. Si la
Collection est spécifiée, la création est une opération O(n), où n est le nombre d'éléments de la Collection.
AComparer est une fonction de comparaison d'égalité. Si elle n'est pas fournie, le comparateur par défaut du type est utilisé.
Voir aussi
OwnsObjects (
Create (
see page 91)
see page 53)
89
46
Delphi Generics.Collections
46
Generics.Collections.TObjectList.OwnsOb
jects
Obtient ou définit la possession des objets.
Description
OwnsObjects obtient ou définit si les objets de la liste sont possédés par la liste, ou pas. Si les entrées sont possédées, quand
un objet d'une entrée est retiré de la liste, il est libéré. Create initialise cette propriété.
Voir aussi
Create (
see page 89)
91
47
Delphi Generics.Collections
47 Generics.Collections.TObjectQueue
File d'attente des objets.
Description
TObjectQueue représente une file d'attente d'objets.
TObjectQueue est un TQueue avec la fonctionnalité de libération automatique des entrées d'objet quand elles sont retirées de la
file d'attente. Quand un TObjectQueue est instancié, un paramètre AOwnsObjects indique si la file d'attente possède les
entrées de la file. Si l'entrée est possédée, quand l'objet de l'entrée est retiré de la file d'attente, il est libéré.
La propriété OwnsObjects obtient ou définit la possession des objets.
Voir aussi
TQueue (
see page 109)
OwnsObjects (
Create (
see page 99)
see page 95)
Dequeue (
see page 97)
93
48
Delphi Generics.Collections
48
Generics.Collections.TObjectQueue.Creat
e
Crée une instance de TObjectQueue.
Description
Cette méthode surchargée crée une instance de TObjectQueue.
Le paramètre AOwnsObjects est un booléen qui indique si les entrées d'objet sont possédées par la file d'attente. Si l'objet est
possédé, quand l'entrée est retirée de la file d'attente, l'objet est libéré. La propriété OwnsObjects est définie à partir de la valeur
de ce paramètre. La valeur par défaut est true.
Collection est une collection permettant d'initialiser la file d'attente. Les objets sont ajoutés dans l'ordre de la Collection. Si la
Collection est spécifiée, la création est une opération O(n), où n est le nombre d'éléments de la Collection.
Voir aussi
OwnsObjects (
Create (
see page 99)
see page 115)
95
49
Delphi Generics.Collections
49
Generics.Collections.TObjectQueue.Dequ
eue
Retire le premier élément de la file d'attente.
Description
Dequeue retire mais ne renvoie pas le premier élément de la file d'attente. La propriété Count est décrémentée de 1. Si Count a
déjà la valeur 0, une erreur est déclenchée.
Remarque: TObjectQueue.Dequeue est différente de TQueue.Dequeue, du fait que c'est une procédure et qu'elle ne renvoie
pas l'élément retiré de la file. Sinon, les deux méthodes fonctionnent de façon similaire. Utilisez TQueue.Peek pour travailler
avec la tête de la file et TQueue.Dequeue lorsque vous avez terminé avec la tête, ou utilisez autrement TQueue.Extract pour
prendre la possession.
Voir aussi
Dequeue (
Extract (
Peek (
see page 117)
see page 123)
see page 127)
97
50
Delphi Generics.Collections
50
Generics.Collections.TObjectQueue.Owns
Objects
Obtient ou définit la possession des objets.
Description
OwnsObjects obtient ou définit si les objets de la file d'attente sont possédés par la file d'attente, ou pas. Si les entrées sont
possédées, quand un objet d'une entrée est retiré de la file d'attente, il est libéré. Create initialise cette propriété.
Voir aussi
Create (
see page 95)
99
51
Delphi Generics.Collections
51 Generics.Collections.TObjectStack
Pile d'objets de style dernier entré premier sorti.
Description
TObjectStack représente une pile d'objets de même type, de style dernier entré premier sorti. La taille est arbitraire et elle
s'étend en cas de besoin. Vous pouvez placer nil sur la pile.
TObjectStack est un TStack avec la fonctionnalité de libération automatique des entrées d'objet quand elles sont retirées de la
pile. Quand un TObjectStack est instancié, un paramètre AOwnsObjects indique si la pile possède les entrées de pile. Si
l'entrée est possédée, quand l'objet de l'entrée est retiré de la pile, il est libéré.
La propriété OwnsObjects obtient ou définit la possession des objets.
Voir aussi
TStack (
see page 131)
OwnsObjects (
Create (
Pop (
see page 105)
see page 103)
see page 107)
101
52
Delphi Generics.Collections
52
Generics.Collections.TObjectStack.Create
Crée une instance de TObjectStack.
Description
Cette méthode surchargée crée une instance de TObjectStack.
Le paramètre AOwnsObjects est un booléen qui indique si les entrées d'objet sont possédées par la pile. Si l'objet est possédé,
quand l'entrée est retirée de la pile, l'objet est libéré. La propriété OwnsObjects est définie à partir de la valeur de ce paramètre.
La valeur par défaut est true.
Collection est une collection permettant d'initialiser la pile. Les objets sont placés sur la pile dans l'ordre de la Collection. Si la
Collection est spécifiée, la création est une opération O(n), où n est le nombre d'éléments de la Collection.
Voir aussi
OwnsObjects (
Create (
see page 105)
see page 137)
103
53
Delphi Generics.Collections
53
Generics.Collections.TObjectStack.Owns
Objects
Obtient ou définit la possession des objets.
Description
OwnsObjects obtient ou définit si les objets de la pile sont possédés par la pile, ou pas. Si les entrées sont possédées, quand un
objet d'une entrée est retiré de la pile, il est libéré. Create initialise cette propriété.
Voir aussi
Create (
see page 103)
105
54
Delphi Generics.Collections
54
Generics.Collections.TObjectStack.Pop
Retire un élément de la pile.
Description
Cette méthode retire un élément au sommet de la pile sans le renvoyer. La propriété Count est décrémentée de 1. Si Count a
déjà la valeur 0, une erreur est déclenchée.
Remarque: TObjectStack.Pop est différente de TStack.Pop, du fait que c'est une procédure et qu'elle ne renvoie pas l'élément
retiré. Sinon, les deux méthodes fonctionnent de façon similaire. Utilisez TStack.Peek pour travailler avec la tête de la pile et
TStack.Pop lorsque vous avez terminé avec la tête, ou utilisez autrement TStack.Extract pour prendre la possession.
Voir aussi
Extract (
Peek (
Pop (
see page 141)
see page 145)
see page 147)
107
55
Delphi Generics.Collections
55 Generics.Collections.TQueue
File d'attente implémentée sur un tableau, avec bouclage.
Description
TQueue est une file d'attente implémentée sur un tableau, avec bouclage.
Vous pouvez ajouter des éléments à la fin de la file d'attente et les retirer du début, ou retirer tous les éléments. Vous pouvez
aussi renvoyer le premier élément sans le retirer. Vous pouvez ajouter des objets nil à la file d'attente.
Count contient le nombre d'éléments de la file d'attente.
Un événement OnNotify vous indique quand la file d'attente a été modifiée.
La classe TObjectQueue hérite de TQueue et fournit un mécanisme automatique de libération des objets retirés des files
d'attente.
Voir aussi
TObjectQueue (
see page 93)
Count (
see page 113)
Clear (
see page 111)
Dequeue (
see page 117)
Enqueue (
see page 121)
Extract (
Peek (
see page 61)
see page 127)
OnNotify (
see page 125)
109
56
Delphi Generics.Collections
56 Generics.Collections.TQueue.Clear
Vide la file d'attente.
Description
Clear retire toutes les entrées de la file d'attente. La propriété Count est définie sur 0. Cela ne modifie pas la capacité. C'est une
opération O(n), où n est la longueur de la file d'attente.
Remarque: Clear ne libère pas les éléments au fur et à mesure qu'ils sont retirés de la file. Si vous avez besoin de les libérer,
utilisez l'événement OnNotify, qui survient pour chaque élément retiré de la file et fournit l'élément retiré.
Voir aussi
Count (
see page 113)
Dequeue (
Destroy (
OnNotify (
see page 117)
see page 119)
see page 125)
111
57
Delphi Generics.Collections
57 Generics.Collections.TQueue.Count
Nombre d'éléments de la file d'attente.
Description
Count obtient le nombre d'éléments de la file d'attente. Cette propriété ne peut pas être définie.
113
58
Delphi Generics.Collections
58 Generics.Collections.TQueue.Create
Crée une file d'attente.
Description
Cette méthode crée et initialise une instance de TQueue. Chaque élément de la Collection est ajouté à la fin de la file d'attente
dans l'ordre de la Collection.
Voir aussi
Destroy (
Enqueue (
see page 119)
see page 121)
115
59
Delphi Generics.Collections
59 Generics.Collections.TQueue.Dequeue
Retire le premier élément de la file d'attente.
Description
Dequeue retire et renvoie le premier élément de la file d'attente. La propriété Count est décrémentée de 1. Si Count a déjà la
valeur 0, une erreur est déclenchée.
Un événement OnNotify survient en indiquant qu'un élément a été retiré de la file d'attente. La méthode Dequeue est identique à
la méthode Extract à l'exception du code d'événement indiquant qu'un élément a été retiré plutôt qu'extrait.
La méthode Dequeue fonctionne de façon similaire à la méthode Peek à l'exception que Dequeue retire un élément de la file
d'attente.
C'est une opération O(1).
Voir aussi
Count (
see page 113)
Enqueue (
Extract (
Peek (
see page 121)
see page 123)
see page 127)
OnNotify (
see page 125)
117
60
Delphi Generics.Collections
60 Generics.Collections.TQueue.Destroy
Détruit une file d'attente.
Description
Cette méthode efface la file d'attente en utilisant la méthode Clear et la détruit.
Remarque: Clear ne libère pas les éléments au fur et à mesure qu'ils sont retirés de la file. Si vous avez besoin de les libérer,
utilisez l'événement OnNotify, qui survient pour chaque élément retiré de la file et fournit l'élément retiré.
Voir aussi
Clear (
Create (
see page 111)
see page 115)
119
61
Delphi Generics.Collections
61 Generics.Collections.TQueue.Enqueue
Ajoute un élément à la fin de la file d'attente.
Description
Enqueue ajoute l'élément donné Value à la fin de la file d'attente. Vous pouvez placer nil dans la file. La propriété Count est
incrémentée de 1. Si Count a atteint la capacité, la taille de la file d'attente est automatiquement augmentée. La propriété Count
est incrémentée de 1.
Un événement OnNotify survient en indiquant qu'un élément a été ajouté à la file d'attente.
C'est une opération O(1), sauf si la capacité doit être augmentée. Dans ce cas, c'est une opération O(n), où n est égal à Count.
Voir aussi
Count (
see page 113)
Dequeue (
see page 117)
OnNotify (
see page 125)
121
62
Delphi Generics.Collections
62 Generics.Collections.TQueue.Extract
Retire le premier élément de la file d'attente.
Description
Extract retire et renvoie le premier élément de la file d'attente. La propriété Count est décrémentée de 1. Si Count a déjà la
valeur 0, une erreur est déclenchée.
Un événement OnNotify survient en indiquant qu'un élément a été retiré de la file d'attente. La méthode Extract est identique à la
méthode Dequeue à l'exception du code d'événement indiquant qu'un élément a été extrait plutôt que retiré.
La méthode Extract fonctionne de façon similaire à la méthode Peek à l'exception que Extract retire un élément de la file
d'attente.
La méthode Extract est similaire à la méthode Dequeue et elle est fournie afin de retirer les éléments sans libération.
C'est une opération O(1).
Voir aussi
Count (
see page 113)
Dequeue (
see page 117)
Enqueue (
see page 121)
Peek (
see page 127)
OnNotify (
see page 125)
123
63
Delphi Generics.Collections
63 Generics.Collections.TQueue.OnNotify
Se produit quand la file d'attente est modifiée.
Description
L'événement OnNotify survient quand des éléments sont ajoutés ou retirés de la file d'attente. Cela permet la libération des
objets retirés.
Voir aussi
Dequeue (
see page 117)
Enqueue (
see page 121)
Extract (
see page 123)
OnNotify (
see page 73)
OnNotify (
see page 143)
TCollectionNotifyEvent (
see page 3)
TCollectionNotification (
see page 1)
125
64
Delphi Generics.Collections
64 Generics.Collections.TQueue.Peek
Obtient le premier élément de la file d'attente.
Description
Peek renvoie le premier élément de la file d'attente sans le retirer. La propriété Count reste inchangée. Aucun événement n'est
généré. Si la propriété Count est égale à 0, une erreur est déclenchée.
La méthode Peek fonctionne de façon similaire à la méthode Dequeue à l'exception que Dequeue retire le premier élément.
C'est une opération O(1).
Voir aussi
Count (
see page 113)
Dequeue (
see page 117)
Enqueue (
see page 121)
Extract (
see page 123)
127
65
Delphi Generics.Collections
65
Generics.Collections.TQueue.TrimExcess
Définit la capacité sur le nombre d'éléments de la file d'attente.
Description
TrimExcess définit la capacité de la file d'attente sur Count.
Voir aussi
Count (
see page 113)
TrimExcess (
see page 31)
TrimExcess (
see page 81)
TrimExcess (
see page 151)
129
66
Delphi Generics.Collections
66 Generics.Collections.TStack
Pile de style dernier entré premier sorti.
Description
TStack représente une pile de style dernier entré premier sorti. La taille est arbitraire et elle s'étend en cas de besoin. Vous
pouvez placer nil sur la pile.
Lorsque la pile est modifiée, un événement OnNotify est généré.
La propriété Count contient le nombre d'entrées de la pile.
La classe TObjectStack hérite de TStack et fournit un mécanisme automatique de libération des objets retirés des piles.
Voir aussi
TObjectStack (
see page 101)
Count (
see page 135)
Clear (
see page 133)
Pop (
Push (
see page 147)
see page 149)
TrimExcess (
OnNotify (
see page 151)
see page 143)
131
67
Delphi Generics.Collections
67 Generics.Collections.TStack.Clear
Efface la pile.
Description
Clear retire toutes les entrées de la pile. La propriété Count, le nombre d'entrées de la pile, est définie sur zéro. La capacité est
aussi définie sur zéro. C'est une opération O(n) où n est égal à Count.
Remarque: Clear ne libère pas les éléments au fur et à mesure qu'ils sont retirés de la pile. Si vous avez besoin de les libérer,
utilisez l'événement OnNotify, qui survient pour chaque élément retiré de la pile et fournit l'élément retiré.
Voir aussi
Count (
see page 135)
Destroy (
Pop (
see page 139)
see page 147)
OnNotify (
see page 143)
133
68
Delphi Generics.Collections
68 Generics.Collections.TStack.Count
Nombre d'entrées de la pile.
Description
La propriété Count contient le nombre d'entrées de la pile. Vous ne pouvez pas écrire dans la propriété Count.
Voir aussi
Clear (
Pop (
Push (
see page 133)
see page 147)
see page 149)
TrimExcess (
see page 151)
135
69
Delphi Generics.Collections
69 Generics.Collections.TStack.Create
Crée une pile.
Description
Cette méthode crée et initialise une instance de TStack.
Collection est une collection dont les objets sont placés sur la pile dans l'ordre de Collection.
Create est une opération O(n), où n est le nombre d'éléments de Collection.
Voir aussi
Destroy (
see page 139)
137
70
Delphi Generics.Collections
70 Generics.Collections.TStack.Destroy
Détruit une instance de pile.
Description
Cette méthode efface une pile en utilisant la méthode Clear et la détruit.
Remarque: Clear ne libère pas les éléments au fur et à mesure qu'ils sont retirés de la pile. Si vous avez besoin de les libérer,
utilisez l'événement OnNotify, qui survient pour chaque élément retiré de la pile et fournit l'élément retiré.
Voir aussi
Clear (
Create (
see page 133)
see page 137)
139
71
Delphi Generics.Collections
71 Generics.Collections.TStack.Extract
Retire le premier élément de la pile.
Description
Extract retire et renvoie le premier élément de la pile. La propriété Count est décrémentée de 1. Si Count a déjà la valeur 0, une
erreur est déclenchée.
Un événement OnNotify survient en indiquant qu'un élément a été retiré de la pile. La méthode Extract est identique à la
méthode Pop à l'exception du code d'événement indiquant qu'un élément a été extrait plutôt que retiré.
La méthode Extract fonctionne de façon similaire à la méthode Peek à l'exception que Extract retire un élément de la pile.
La méthode Extract est similaire à la méthode Pop et elle est fournie afin de retirer les éléments sans libération.
C'est une opération O(1).
Voir aussi
Count (
Pop (
Push (
see page 135)
see page 147)
see page 149)
OnNotify (
see page 143)
141
72
Delphi Generics.Collections
72 Generics.Collections.TStack.OnNotify
Se produit quand la pile est modifiée.
Description
L'événement OnNotify survient quand des éléments sont ajoutés ou retirés de la pile. Cela permet la libération des objets retirés.
Voir aussi
OnNotify (
see page 73)
OnNotify (
see page 125)
TCollectionNotifyEvent (
see page 3)
TCollectionNotification (
see page 1)
143
73
Delphi Generics.Collections
73 Generics.Collections.TStack.Peek
Recherche le premier élément de la pile.
Description
Peek renvoie l'élément situé en haut de la pile sans le retirer. Si la propriété Count est égale à 0, une erreur est déclenchée. La
propriété Count reste inchangée.
La méthode Pop fonctionne de façon similaire à la méthode Peek à l'exception que Pop retire un élément de la pile.
C'est une opération O(1).
Voir aussi
Count (
Pop (
see page 135)
see page 147)
145
74
Delphi Generics.Collections
74 Generics.Collections.TStack.Pop
Retire un élément de la pile.
Description
Cette méthode retire un élément au sommet de la pile et le renvoie. La propriété Count est décrémentée de 1. Si Count a déjà la
valeur 0, une erreur est déclenchée.
Un événement OnNotify survient en indiquant qu'un élément a été retiré de la pile. La méthode Pop est identique à la méthode
Extract à l'exception du code d'événement indiquant qu'un élément a été retiré plutôt qu'extrait.
La méthode Pop fonctionne de façon similaire à la méthode Peek à l'exception que Pop retire un élément de la pile.
C'est une opération O(1).
Voir aussi
Count (
see page 135)
Clear (
see page 133)
Extract (
Push (
see page 141)
see page 149)
OnNotify (
see page 143)
147
75
Delphi Generics.Collections
75 Generics.Collections.TStack.Push
Insère un élément au sommet de la pile.
Description
Cette méthode insère un élément au sommet de la pile. La propriété Count est incrémentée de 1. Vous pouvez placer nil sur la
pile. La capacité de la pile est automatiquement augmentée si nécessaire.
Un événement OnNotify survient en indiquant qu'un élément a été ajouté à la pile.
C'est une opération O(1), sauf si la capacité doit être augmentée. Dans ce cas, c'est une opération O(n), où n est égal à Count.
Voir aussi
Count (
see page 135)
Extract (
Pop (
see page 141)
see page 147)
OnNotify (
see page 143)
149
76
Delphi Generics.Collections
76
Generics.Collections.TStack.TrimExcess
Définit la capacité sur le nombre d'éléments en cours.
Description
TrimExcess définit la capacité sur le nombre d'éléments de la pile.
Voir aussi
Count (
see page 135)
TrimExcess (
see page 31)
TrimExcess (
see page 81)
TrimExcess (
see page 129)
151
77
Delphi Generics.Collections
77 Generics.Collections
153
78
Delphi Generics.Collections
Index
Generics.Collections.TList.Items 69
Generics.Collections.TList.LastIndexOf 71
Generics.Collections.TList.OnNotify 73
G
Generics.Collections.TList.Remove 75
Generics.Collections 153
Generics.Collections.TList.Reverse 77
Generics.Collections.TCollectionNotification 1
Generics.Collections.TList.Sort 79
Generics.Collections.TCollectionNotifyEvent 3
Generics.Collections.TList.TrimExcess 81
Generics.Collections.TDictionary 5
Generics.Collections.TObjectDictionary 83
Generics.Collections.TDictionary.Add 7
Generics.Collections.TObjectDictionary.Create 85
Generics.Collections.TDictionary.AddOrSetValue 9
Generics.Collections.TObjectList 87
Generics.Collections.TDictionary.Clear 11
Generics.Collections.TObjectList.Create 89
Generics.Collections.TDictionary.ContainsKey 13
Generics.Collections.TObjectList.OwnsObjects 91
Generics.Collections.TDictionary.ContainsValue 15
Generics.Collections.TObjectQueue 93
Generics.Collections.TDictionary.Count 17
Generics.Collections.TObjectQueue.Create 95
Generics.Collections.TDictionary.Create 19
Generics.Collections.TObjectQueue.Dequeue 97
Generics.Collections.TDictionary.Destroy 21
Generics.Collections.TObjectQueue.OwnsObjects 99
Generics.Collections.TDictionary.Items 23
Generics.Collections.TObjectStack 101
Generics.Collections.TDictionary.OnKeyNotify 25
Generics.Collections.TObjectStack.Create 103
Generics.Collections.TDictionary.OnValueNotify 27
Generics.Collections.TObjectStack.OwnsObjects 105
Generics.Collections.TDictionary.Remove 29
Generics.Collections.TObjectStack.Pop 107
Generics.Collections.TDictionary.TrimExcess 31
Generics.Collections.TQueue 109
Generics.Collections.TDictionary.TryGetValue 33
Generics.Collections.TQueue.Clear 111
Generics.Collections.TDictionaryOwnerships 35
Generics.Collections.TQueue.Count 113
Generics.Collections.TList 37
Generics.Collections.TQueue.Create 115
Generics.Collections.TList.Add 39
Generics.Collections.TQueue.Dequeue 117
Generics.Collections.TList.AddRange 41
Generics.Collections.TQueue.Destroy 119
Generics.Collections.TList.BinarySearch 43
Generics.Collections.TQueue.Enqueue 121
Generics.Collections.TList.Capacity 45
Generics.Collections.TQueue.Extract 123
Generics.Collections.TList.Clear 47
Generics.Collections.TQueue.OnNotify 125
Generics.Collections.TList.Contains 49
Generics.Collections.TQueue.Peek 127
Generics.Collections.TList.Count 51
Generics.Collections.TQueue.TrimExcess 129
Generics.Collections.TList.Create 53
Generics.Collections.TStack 131
Generics.Collections.TList.Delete 55
Generics.Collections.TStack.Clear 133
Generics.Collections.TList.DeleteRange 57
Generics.Collections.TStack.Count 135
Generics.Collections.TList.Destroy 59
Generics.Collections.TStack.Create 137
Generics.Collections.TList.Extract 61
Generics.Collections.TStack.Destroy 139
Generics.Collections.TList.IndexOf 63
Generics.Collections.TStack.Extract 141
Generics.Collections.TList.Insert 65
Generics.Collections.TStack.OnNotify 143
Generics.Collections.TList.InsertRange 67
Generics.Collections.TStack.Peek 145
a
Delphi Generics.Collections
Generics.Collections.TStack.Pop 147
Generics.Collections.TStack.Push 149
Generics.Collections.TStack.TrimExcess 151
b
78