System.Generics.Collections.TThreadedQueue.PopItem
Delphi
function PopItem: T; overload;
function PopItem(var AQueueSize: Integer): T; overload;
function PopItem(var AQueueSize: Integer; var AItem: T): TWaitResult; overload;
function PopItem(var AItem: T): TWaitResult; overload;
C++
T __fastcall PopItem(void)/* overload */;
T __fastcall PopItem(int &AQueueSize)/* overload */;
System::Types::TWaitResult __fastcall PopItem(int &AQueueSize, T &AItem)/* overload */;
System::Types::TWaitResult __fastcall PopItem(T &AItem)/* overload */;
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | System.Generics.Collections.pas System.Generics.Collections.hpp |
System.Generics.Collections | TThreadedQueue |
Beschreibung
Entfernt ein Element aus der Warteschlange.
Mit PushItem können Sie ein Element aus der Warteschlange gemäß des FIFO-Datenverwaltungsprinzip (First In - First Out) entfernen.
Es gibt vier überladene Methoden PopItem:
- Ohne Parameter — diese Methode gibt das entfernte Element zurück.
- Mit einem Parameter
AQueueSize
— diese Methode gibt auch das entfernte Element zurück.
- Mit zwei Parametern:
AQueueSize
undAItem
. Mit dem ParameterAQueueSize
wird die Position desAItem
-Elements festegelegt.
- Mit einem Parameter
AItem
.
Die letzten zwei Methoden geben ein TWaitResult zurück. Wenn die Warteschlange leer ist, wartet der Monitor darauf, dass sie ein Element gelegt. Wenn kein Element während der von PopTimeout gekennzeichneten Zeit gelegt wird, gibt die Methode wrTimeout zurück; ansonsten wird wrSignaled zurückgegeben.
Verwenden Sie die letzten zwei Methoden, um sicherzustellen, ob die Entfernungsoperation erfolgreich abgeschlossen wurde.