IQueue Interface
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Collection conçue pour contenir des éléments avant le traitement.
[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é
- Attributs
- Implémente
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
| Handle |
Obtient la valeur JNI de l’objet Android sous-jacent. (Hérité de IJavaObject) |
| IsEmpty |
Retourne si cela |
| JniIdentityHashCode |
Retourne la valeur de |
| JniManagedPeerState |
État de l’homologue managé. (Hérité de IJavaPeerable) |
| JniPeerMembers |
Prise en charge de l’accès aux membres et de l’appel. (Hérité de IJavaPeerable) |
| PeerReference |
Retourne une JniObjectReference instance d’objet Java encapsulée. (Hérité de IJavaPeerable) |
Méthodes
| Add(Object) |
Insère l’élément spécifié dans cette file d’attente s’il est possible de le faire immédiatement sans violer les restrictions de capacité, en retournant |
| AddAll(ICollection) |
Ajoute tous les éléments de la collection spécifiée à cette collection (opération facultative). (Hérité de ICollection) |
| Clear() |
Supprime tous les éléments de cette collection (opération facultative). (Hérité de ICollection) |
| Contains(Object) |
Retourne |
| ContainsAll(ICollection) |
Retourne |
| Disposed() |
Appelé lorsque l’instance a été supprimée. (Hérité de IJavaPeerable) |
| DisposeUnlessReferenced() |
S’il n’existe aucune référence en suspens à cette instance, les appels |
| Element() |
Récupère, mais ne supprime pas, la tête de cette file d’attente. |
| Equals(Object) |
Compare l’objet spécifié à cette collection pour l’égalité. (Hérité de ICollection) |
| Finalized() |
Appelé lorsque l’instance a été finalisée. (Hérité de IJavaPeerable) |
| ForEach(IConsumer) |
Exécute l’action donnée pour chaque élément jusqu’à |
| GetHashCode() |
Retourne la valeur du code de hachage pour cette collection. (Hérité de ICollection) |
| Iterator() |
Retourne un itérateur sur les éléments de cette collection. (Hérité de ICollection) |
| Offer(Object) |
Insère l’élément spécifié dans cette file d’attente s’il est possible de le faire immédiatement sans violer les restrictions de capacité. |
| Peek() |
Récupère, mais ne supprime pas, la tête de cette file d’attente ou retourne |
| Poll() |
Récupère et supprime la tête de cette file d’attente ou retourne |
| Remove() |
Récupère et supprime la tête de cette file d’attente. |
| Remove(Object) |
Supprime une seule instance de l’élément spécifié de cette collection, s’il est présent (opération facultative). (Hérité de ICollection) |
| RemoveAll(ICollection) |
Supprime tous les éléments de cette collection qui sont également contenus dans la collection spécifiée (opération facultative). (Hérité de ICollection) |
| RemoveIf(IPredicate) |
Supprime tous les éléments de cette collection qui répondent au prédicat donné. (Hérité de ICollection) |
| RetainAll(ICollection) |
Conserve uniquement les éléments de cette collection contenus dans la collection spécifiée (opération facultative). (Hérité de ICollection) |
| SetJniIdentityHashCode(Int32) |
Définissez la valeur retournée par |
| SetJniManagedPeerState(JniManagedPeerStates) |
Collection conçue pour contenir des éléments avant le traitement. (Hérité de IJavaPeerable) |
| SetPeerReference(JniObjectReference) |
Définissez la valeur retournée par |
| Size() |
Retourne le nombre d’éléments de cette collection. (Hérité de ICollection) |
| Spliterator() |
Crée un |
| ToArray() |
Retourne un tableau contenant tous les éléments de cette collection. (Hérité de ICollection) |
| ToArray(IIntFunction) |
Retourne un tableau contenant tous les éléments de cette collection, à l’aide de la fonction fournie |
| ToArray(Object[]) |
Retourne un tableau contenant tous les éléments de cette collection ; le type d’exécution du tableau retourné est celui du tableau spécifié. (Hérité de ICollection) |
| UnregisterFromRuntime() |
Annulez l’inscription de cette instance afin que le runtime ne le retourne pas à partir d’appels futurs Java.Interop.JniRuntime+JniValueManager.PeekValue . (Hérité de IJavaPeerable) |
Implémentations d’interfaces explicites
| IIterable.Spliterator() |
Crée un |
Méthodes d’extension
| JavaCast<TResult>(IJavaObject) |
Effectue une conversion de type vérifiée par le runtime Android. |
| JavaCast<TResult>(IJavaObject) |
Collection conçue pour contenir des éléments avant le traitement. |
| GetJniTypeName(IJavaPeerable) |
Collection conçue pour contenir des éléments avant le traitement. |
| ToEnumerable(IIterable) |
Collection conçue pour contenir des éléments avant le traitement. |
| ToEnumerable<T>(IIterable) |
Collection conçue pour contenir des éléments avant le traitement. |