System.Generics.Collections.TThreadedQueue.PopItem

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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()/* 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 und AItem. Mit dem Parameter AQueueSize wird die Position des AItem-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.

Siehe auch