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 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 elementi prima dell'elaborazione. Oltre alle operazioni di base Collection
, le code forniscono operazioni di inserimento, estrazione e ispezione aggiuntive. Ognuno di questi metodi esiste in due forme: uno genera un'eccezione se l'operazione non riesce, l'altra restituisce un valore speciale ( null
o false
, 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">didascalia Summary of Queue methods</didascalia>< 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">Restituisce un valore< speciale/th></tr<>/thead<>><tbody><tr><th scope="row">Insert</th<>td#add(Object) add(e)
<>/td td/td>#offer(Object) offer(e)
<<>></tr tr<><>th scope="row">Remove</th<>td/td#remove() remove()
><>><#poll() poll()
< td></tr tr<>><th scope="row">Examine</th><td/td><#element() element()
td>><<#peek() peek()
/tr>><</tbody></tavolo>
Le code in genere, ma non necessariamente, ordinano gli elementi in modo FIFO (first-in-first-out). Tra le eccezioni sono presenti code di priorità, che ordinano gli elementi in base a un confronto 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'em <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>/em> della coda. Altri tipi di code possono usare regole di posizionamento diverse. Ogni Queue
implementazione deve specificare le proprietà di ordinamento.
Se possibile, il #offer offer
metodo inserisce un elemento, altrimenti restituisce false
. Ciò è diverso 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 nella capacità fissa (o &virgolette; delimitato&virgolette;) 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 della 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, null
non deve essere inserito in un Queue
oggetto , 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 Android e usato in base ai termini descritti in 2.5 Attribution License Creative Commons 2.5 Attribution License.
Proprietà
Handle |
Ottiene il valore JNI dell'oggetto Android sottostante. (Ereditato da IJavaObject) |
IsEmpty |
Restituisce se non |
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 della coda. |
Equals(Object) |
Confronta l'oggetto specificato con questa raccolta per verificarne 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 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 di questa raccolta. (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 di questa raccolta; 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 oggetto |
Metodi di estensione
JavaCast<TResult>(IJavaObject) |
Esegue una conversione del tipo verificato dal runtime Android. |
JavaCast<TResult>(IJavaObject) |
Raccolta progettata per contenere elementi prima dell'elaborazione. |
GetJniTypeName(IJavaPeerable) |
Raccolta progettata per contenere elementi prima dell'elaborazione. |
ToEnumerable(IIterable) |
Raccolta progettata per contenere elementi prima dell'elaborazione. |
ToEnumerable<T>(IIterable) |
Raccolta progettata per contenere elementi prima dell'elaborazione. |