IQueue Interface

Définition

[Android.Runtime.Register("java/util/Queue", "", "Java.Util.IQueueInvoker")]
[Java.Interop.JavaTypeParameters(new System.String[] { "E" })]
public interface IQueue : IDisposable, Java.Interop.IJavaPeerable, Java.Util.ICollection

[<Android.Runtime.Register("java/util/Queue", "", "Java.Util.IQueueInvoker")>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "E" })>]
type IQueue = interface
    interface ICollection
    interface IIterable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Dérivé

Java.Util.AbstractQueue

Java.Util.ArrayDeque

Java.Util.Concurrent.ArrayBlockingQueue

Java.Util.Concurrent.ConcurrentLinkedDeque

Java.Util.Concurrent.ConcurrentLinkedQueue

Plus…

Attributs

RegisterAttribute JavaTypeParametersAttribute

Implémente

IJavaObject IJavaPeerable IIterable ICollection IDisposable

Remarques

Collection conçue pour contenir des éléments avant le traitement. Outre les opérations de base Collection , les files d’attente fournissent des opérations d’insertion, d’extraction et d’inspection supplémentaires. Chacune de ces méthodes existe sous deux formes : l’une lève une exception si l’opération échoue, l’autre retourne une valeur spéciale (soit nullfalse, selon l’opération). La dernière forme de l’opération d’insertion est conçue spécifiquement pour une utilisation avec des implémentations limitées Queue à la capacité ; dans la plupart des implémentations, les opérations d’insertion ne peuvent pas échouer.

<table class="striped">caption Summary of Queue methods</caption><thead><tr><td/td>><< th scope="col » style="font-weight :normal ; font-style :italic">Throws exception</<>th th scope="col » style="font-weight :normal ; font-style :italic">Renvoie une valeur< spéciale/th<>/tr<>/thead<>tbody><tr<>th scope="row">Insert</thth<>><td>#add(Object) add(e)</td>#offer(Object) offer(e)<></tr>< tr><><th scope="row">Remove</th<>td<>#remove() remove()/td><>#poll() poll()</td/td<>/tr tr><<>th scope="row">Examine</th><td#element() element()<>/td/td/td<#peek() peek()>/td></tr<>/tbody><></table>

En règle générale, les files d’attente, mais pas nécessairement, trient les éléments d’une manière FIFO (premier entré en premier sorti). Parmi les exceptions figurent les files d’attente prioritaires, qui trient les éléments en fonction d’un comparateur fourni, ou l’ordre naturel des éléments et les files d’attente LIFO (ou piles) qui trient les éléments LIFO (last-in-first-out). Quel que soit l’ordre utilisé, la <>tête< em/em> de la file d’attente est cet élément qui serait supprimé par un appel à #remove() ou #poll(). Dans une file d’attente FIFO, tous les nouveaux éléments sont insérés à la <>queue</em> de la file d’attente. D’autres types de files d’attente peuvent utiliser des règles de placement différentes. Chaque Queue implémentation doit spécifier ses propriétés de classement.

La #offer offer méthode insère un élément si possible, sinon en retournant false. Cela diffère de la java.util.Collection#add Collection.add méthode, qui ne peut pas ajouter un élément uniquement en lève une exception non cochée. La offer méthode est conçue pour être utilisée lorsque l’échec est une occurrence normale, plutôt qu’une occurrence exceptionnelle, par exemple, dans une capacité fixe (ou " bounded") Files.

Les #remove() méthodes suppriment et #poll() retournent la tête de la file d’attente. Exactement quel élément est supprimé de la file d’attente est une fonction de la stratégie de classement de la file d’attente, qui diffère de l’implémentation à l’implémentation. Les remove() méthodes diffèrent poll() uniquement dans leur comportement lorsque la file d’attente est vide : la remove() méthode lève une exception, tandis que la poll() méthode retourne null.

Les #element() méthodes retournent #peek() , mais ne suppriment pas, la tête de la file d’attente.

L’interface Queue ne définit pas les méthodes de file d’attente bloquantes, qui sont courantes dans la programmation simultanée. Ces méthodes, qui attendent que les éléments apparaissent ou que l’espace soit disponible, sont définies dans l’interface java.util.concurrent.BlockingQueue , ce qui étend cette interface.

Queue les implémentations n’autorisent généralement pas l’insertion d’éléments null , bien que certaines implémentations, telles que LinkedList, n’interdisent pas l’insertion de null. Même dans les implémentations qui l’autorisent, null ne doit pas être insérée dans un Queue, car null elle est également utilisée comme valeur de retour spéciale par la méthode pour indiquer que la poll file d’attente ne contient aucun élément.

Queue Les implémentations ne définissent généralement pas les versions basées sur des éléments de méthodes equals et hashCode héritent plutôt des versions basées sur l’identité de la classe Object, car l’égalité basée sur les éléments n’est pas toujours bien définie pour les files d’attente avec les mêmes éléments, mais différentes propriétés de classement.

Ajouté à la version 1.5.

Documentation Java pour java.util.Queue.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

Propriétés

Méthodes

Implémentations d’interfaces explicites

Méthodes d’extension

S’applique à