IQueue Interfaccia
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Raccolta progettata per contenere gli elementi prima dell'elaborazione.
[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- Derivato
- Attributi
- Implementazioni
Commenti
Raccolta progettata per contenere gli elementi prima dell'elaborazione. Oltre alle operazioni di base Collection , le code forniscono ulteriori operazioni di inserimento, estrazione e ispezione. Ognuno di questi metodi esiste in due forme: uno genera un'eccezione se l'operazione ha esito negativo, l'altra restituisce un valore speciale (o false, null a seconda dell'operazione). Quest'ultima forma dell'operazione di inserimento è progettata specificamente per l'uso con implementazioni con restrizioni Queue di capacità. Nella maggior parte delle implementazioni, le operazioni di inserimento non possono avere esito negativo.
<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<>scope="col" style="font-weight:normal; font-style:italic">Returns special value</th<>/tr/thead><tbody><tr<<>> th scope="row">Insert</th<>><td>#add(Object) add(e)</td td><<>#offer(Object) offer(e)/td></tr tr>><<th scope="row">Remove</th><td>#remove() remove()</td td><#poll() poll()></<>tr tr><><th scope="row">Examine</th<>td/td td#peek() peek()>#element() element()><</td><<>/tr<>/tbody></table>
Le code in genere, ma non necessariamente, ordinano gli elementi in modo FIFO (first-in-first-out). Tra le eccezioni ci sono code di priorità, che ordinano gli elementi in base a un comparatore fornito o all'ordinamento naturale degli elementi e alle code LIFO (o stack) che ordinano gli elementi LIFO (last-in-first-out). Indipendentemente dall'ordinamento usato, l'elemento <head</em>> della coda è l'elemento che verrebbe rimosso da una chiamata a #remove() o #poll(). In una coda FIFO tutti i nuovi elementi vengono inseriti nella <coda<> em>della coda. Altri tipi di code possono usare regole di posizionamento diverse. Ogni Queue implementazione deve specificare le relative proprietà di ordinamento.
Il #offer offer metodo inserisce un elemento, se possibile, in caso contrario restituisce false. Ciò differisce dal java.util.Collection#add Collection.add metodo , che può non riuscire ad aggiungere un elemento solo generando un'eccezione deselezionata. Il offer metodo è progettato per l'uso quando l'errore è normale, anziché un'occorrenza eccezionale, ad esempio in capacità fissa (o " delimitato") Code.
I #remove() metodi e #poll() rimuovono e restituiscono l'intestazione della coda. Esattamente quale elemento viene rimosso dalla coda è una funzione dei criteri di ordinamento della coda, che differisce dall'implementazione all'implementazione. I remove() metodi e poll() differiscono solo nel comportamento quando la coda è vuota: il remove() metodo genera un'eccezione, mentre il poll() metodo restituisce null.
I #element() metodi e #peek() restituiscono, ma non rimuovere, l'intestazione della coda.
L'interfaccia Queue non definisce i metodi di coda di blocco, comuni nella programmazione simultanea. Questi metodi, che attendono che gli elementi vengano visualizzati o che lo spazio diventi disponibile, sono definiti nell'interfaccia java.util.concurrent.BlockingQueue , che estende questa interfaccia.
Queue le implementazioni in genere non consentono l'inserimento di null elementi, anche se alcune implementazioni, ad esempio LinkedList, non impediscono l'inserimento di null. Anche nelle implementazioni che lo consentono, non deve essere inserito in un Queueoggetto null , come null viene usato anche come valore restituito speciale dal poll metodo per indicare che la coda non contiene elementi.
Queue le implementazioni in genere non definiscono versioni basate su elementi di metodi equals e hashCode ereditano invece le versioni basate su identità dalla classe Object, perché l'uguaglianza basata su elementi non è sempre ben definita per le code con gli stessi elementi ma proprietà di ordinamento diverse.
Aggiunto nella versione 1.5.
Documentazione java per java.util.Queue.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.
Proprietà
| Handle |
Ottiene il valore JNI dell'oggetto Android sottostante. (Ereditato da IJavaObject) |
| IsEmpty |
Restituisce se l'oggetto |
| JniIdentityHashCode |
Restituisce il valore di |
| JniManagedPeerState |
Stato del peer gestito. (Ereditato da IJavaPeerable) |
| JniPeerMembers |
Supporto per l'accesso ai membri e la chiamata. (Ereditato da IJavaPeerable) |
| PeerReference |
Restituisce un JniObjectReference oggetto dell'istanza dell'oggetto Java di cui è stato eseguito il wrapping. (Ereditato da IJavaPeerable) |
Metodi
| Add(Object) |
Inserisce l'elemento specificato in questa coda se è possibile farlo immediatamente senza violare le restrizioni di capacità, restituendo |
| AddAll(ICollection) |
Aggiunge tutti gli elementi della raccolta specificata a questa raccolta (operazione facoltativa). (Ereditato da ICollection) |
| Clear() |
Rimuove tutti gli elementi da questa raccolta (operazione facoltativa). (Ereditato da ICollection) |
| Contains(Object) |
Restituisce |
| ContainsAll(ICollection) |
Restituisce |
| Disposed() |
Chiamato quando l'istanza è stata eliminata. (Ereditato da IJavaPeerable) |
| DisposeUnlessReferenced() |
Se non sono presenti riferimenti in sospeso a questa istanza, chiama |
| Element() |
Recupera, ma non rimuove, l'intestazione di questa coda. |
| Equals(Object) |
Confronta l'oggetto specificato con questa raccolta per verificare l'uguaglianza. (Ereditato da ICollection) |
| Finalized() |
Chiamato quando l'istanza è stata finalizzata. (Ereditato da IJavaPeerable) |
| ForEach(IConsumer) |
Esegue l'azione specificata per ogni elemento di |
| GetHashCode() |
Restituisce il valore del codice hash per questa raccolta. (Ereditato da ICollection) |
| Iterator() |
Restituisce un iteratore sugli elementi di questa raccolta. (Ereditato da ICollection) |
| Offer(Object) |
Inserisce l'elemento specificato in questa coda se è possibile farlo immediatamente senza violare le restrizioni di capacità. |
| Peek() |
Recupera, ma non rimuove, l'intestazione della coda o restituisce |
| Poll() |
Recupera e rimuove l'intestazione della coda oppure restituisce |
| Remove() |
Recupera e rimuove l'intestazione della coda. |
| Remove(Object) |
Rimuove una singola istanza dell'elemento specificato da questa raccolta, se presente (operazione facoltativa). (Ereditato da ICollection) |
| RemoveAll(ICollection) |
Rimuove tutti gli elementi di questa raccolta contenuti anche nella raccolta specificata (operazione facoltativa). (Ereditato da ICollection) |
| RemoveIf(IPredicate) |
Rimuove tutti gli elementi di questa raccolta che soddisfano il predicato specificato. (Ereditato da ICollection) |
| RetainAll(ICollection) |
Mantiene solo gli elementi di questa raccolta contenuti nella raccolta specificata (operazione facoltativa). (Ereditato da ICollection) |
| SetJniIdentityHashCode(Int32) |
Impostare il valore restituito da |
| SetJniManagedPeerState(JniManagedPeerStates) |
Raccolta progettata per contenere gli elementi prima dell'elaborazione. (Ereditato da IJavaPeerable) |
| SetPeerReference(JniObjectReference) |
Impostare il valore restituito da |
| Size() |
Restituisce il numero di elementi in questa raccolta. (Ereditato da ICollection) |
| Spliterator() |
Crea un |
| ToArray() |
Restituisce una matrice contenente tutti gli elementi dell'insieme. (Ereditato da ICollection) |
| ToArray(IIntFunction) |
Restituisce una matrice contenente tutti gli elementi di questa raccolta, utilizzando la funzione fornita |
| ToArray(Object[]) |
Restituisce una matrice contenente tutti gli elementi dell'insieme; Il tipo di runtime della matrice restituita è quello della matrice specificata. (Ereditato da ICollection) |
| UnregisterFromRuntime() |
Annullare la registrazione di questa istanza in modo che il runtime non lo restituisca dalle chiamate future Java.Interop.JniRuntime+JniValueManager.PeekValue . (Ereditato da IJavaPeerable) |
Implementazioni dell'interfaccia esplicita
| IIterable.Spliterator() |
Crea un |
Metodi di estensione
| JavaCast<TResult>(IJavaObject) |
Esegue una conversione del tipo di tipo controllato dal runtime Android. |
| JavaCast<TResult>(IJavaObject) |
Raccolta progettata per contenere gli elementi prima dell'elaborazione. |
| GetJniTypeName(IJavaPeerable) |
Raccolta progettata per contenere gli elementi prima dell'elaborazione. |
| ToEnumerable(IIterable) |
Raccolta progettata per contenere gli elementi prima dell'elaborazione. |
| ToEnumerable<T>(IIterable) |
Raccolta progettata per contenere gli elementi prima dell'elaborazione. |