System.Generics.Collections.TThreadedQueue.PopItem

De RAD Studio API Documentation
Aller à : navigation, rechercher

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 PushItem pour retirer un élément de la file d'attente selon la gestion des données First In, First Out.

Il existe 4 méthodes PopItem surchargées :

  • Sans paramètres -- cette méthode renvoie l'élément retiré.
  • Avec un paramètre AQueueSize -- cette méthode renvoie également l'élément retiré.
  • Avec deux 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 qu'elle ajoute un élément. Si aucun élément n'est ajouté pendant PopTimeout, la méthode renvoie wrTimeout ; sinon, la méthode renvoie wrSignaled.

Utilisez les deux dernières méthodes lorsque vous voulez savoir si l'ajout a été exécuté avec succès.

Voir aussi