System.Generics.Collections.TThreadedQueue.PopItem

• Aller au parent : TThreadedQueue

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 */;

Propriétés

Type	Visibilité	Source	Unité	Parent
function	public	System.Generics.Collections.pas System.Generics.Collections.hpp	System.Generics.Collections	TThreadedQueue

Description

Retire un élément de la file d'attente.

Utilisez PopItem pour retirer un élément de la file d'attente en fonction de la méthode de gestion de données FIFO, First In, First Out.

Quatre méthodes PopItem de surcharge sont disponibles :

• Sans paramètres : cette méthode renvoie l'élément retiré.
• Avec un paramètre AQueueSize : cette méthode renvoie aussi l'élément retiré.
• Avec les paramètres AQueueSize et AItem : AQueueSize spécifie la position de l'élément AItem.
• Avec un paramètre AItem.

Les deux dernières méthodes renvoient un TWaitResult. Si la file d'attente est vide, le moniteur attend ce paramètre pour ajouter un élément. Si aucun élément n'est ajouté pendant PopTimeout, la méthode renvoie wrTimeout ; sinon, elle renvoie wrSignaled.

Si vous avez besoin de savoir si le retrait de l'élément a correctement été effectué, utilisez les deux dernières méthodes.

Voir aussi

• System.Generics.Collections.TThreadedQueue.PushItem
• System.Generics.Collections.TThreadedQueue.Create
• System.SyncObjs.TWaitResult