IQueue Antarmuka

Definisi

Ruang nama:

Java.Util

Rakitan:

Mono.Android.dll

Koleksi yang dirancang untuk menahan elemen sebelum diproses.

[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

Turunan

Java.Util.AbstractQueue

Java.Util.ArrayDeque

Java.Util.Concurrent.ArrayBlockingQueue

Java.Util.Concurrent.ConcurrentLinkedDeque

Java.Util.Concurrent.ConcurrentLinkedQueue

Java.Util.Concurrent.DelayQueue

Java.Util.Concurrent.IBlockingDeque

Java.Util.Concurrent.IBlockingQueue

Java.Util.Concurrent.ITransferQueue

Java.Util.Concurrent.LinkedBlockingDeque

Java.Util.Concurrent.LinkedBlockingQueue

Java.Util.Concurrent.LinkedTransferQueue

Java.Util.Concurrent.PriorityBlockingQueue

Java.Util.Concurrent.SynchronousQueue

Java.Util.IDeque

Java.Util.LinkedList

Atribut

RegisterAttribute JavaTypeParametersAttribute

Penerapan

IJavaObject IJavaPeerable IIterable ICollection IDisposable

Keterangan

Koleksi yang dirancang untuk menahan elemen sebelum diproses. Selain operasi dasar Collection , antrean menyediakan operasi penyisipan, ekstraksi, dan inspeksi tambahan. Masing-masing metode ini ada dalam dua bentuk: satu melempar pengecualian jika operasi gagal, yang lain mengembalikan nilai khusus (baik null atau false, tergantung pada operasi). Bentuk terakhir dari operasi penyisipan dirancang khusus untuk digunakan dengan implementasi yang dibatasi Queue kapasitas; di sebagian besar implementasi, operasi sisipan tidak dapat gagal.

<table class="striped">caption>Summary of Queue methods</caption><thead<>tr<>td></td><th scope="col" style="font-weight:normal; font-style:italic">Melempar pengecualian</th th<>scope="col" style="font-weight:normal; font-style:italic">Menampilkan nilai< khusus/th<>/tr<>/thead<>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<>>#poll() poll()</td/td></tr tr><<>th scope="row">Examine</th><td><#element() element()/td#peek() peek()>><</td<>/tr/tr<>/tbody></table>

Antrean biasanya, tetapi tidak selalu, mengurutkan elemen dengan cara FIFO (first-in-first-out). Di antara pengecualian adalah antrean prioritas, yang mengurutkan elemen sesuai dengan komparator yang disediakan, atau urutan alami elemen, dan antrean LIFO (atau tumpukan) yang mengurutkan elemen LIFO (last-in-first-out). Apa pun pemesanan yang digunakan, <kepala</em> dari>antrean adalah elemen yang akan dihapus oleh panggilan ke #remove() atau #poll(). Dalam antrean FIFO, semua elemen baru dimasukkan ke <ekor< em>/em> antrean. Jenis antrean lainnya dapat menggunakan aturan penempatan yang berbeda. Setiap Queue implementasi harus menentukan properti pemesanannya.

Metode #offer offer menyisipkan elemen jika memungkinkan, jika tidak mengembalikan false. Ini berbeda dari java.util.Collection#add Collection.add metode , yang dapat gagal menambahkan elemen hanya dengan melemparkan pengecualian yang tidak dicentang. Metode offer ini dirancang untuk digunakan ketika kegagalan adalah normal, bukan kejadian luar biasa, misalnya, dalam kapasitas tetap (atau " &terikat;) Antrian.

Metode #remove() dan #poll() menghapus dan mengembalikan kepala antrean. Tepatnya elemen mana yang dihapus dari antrean adalah fungsi dari kebijakan pemesanan antrean, yang berbeda dari implementasi ke implementasi. Metode remove() dan poll() hanya berbeda dalam perilaku mereka ketika antrean kosong: remove() metode melemparkan pengecualian, sementara poll() metode mengembalikan null.

Metode #element() dan #peek() kembali, tetapi jangan hapus, kepala antrean.

Antarmuka Queue tidak menentukan metode antrean pemblokiran, yang umum dalam pemrograman bersamaan. Metode ini, yang menunggu elemen muncul atau ruang tersedia, didefinisikan dalam java.util.concurrent.BlockingQueue antarmuka, yang memperluas antarmuka ini.

Queue implementasi umumnya tidak mengizinkan penyisipan null elemen, meskipun beberapa implementasi, seperti LinkedList, tidak melarang penyisipan null. Bahkan dalam implementasi yang mengizinkannya, null tidak boleh dimasukkan ke dalam Queue, seperti null juga digunakan sebagai nilai pengembalian khusus dengan poll metode untuk menunjukkan bahwa antrean tidak berisi elemen.

Queue implementasi umumnya tidak menentukan versi metode equals berbasis elemen dan hashCode tetapi sebaliknya mewarisi versi berbasis identitas dari kelas Object, karena kesetaraan berbasis elemen tidak selalu didefinisikan dengan baik untuk antrean dengan elemen yang sama tetapi properti pengurutan yang berbeda.

Ditambahkan dalam 1.5.

Dokumentasi Java untuk java.util.Queue.

Bagian halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Proyek Sumber Terbuka Android dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Atribusi Creative Commons 2.5.

Properti

Handle	Mendapatkan nilai JNI dari objek Android yang mendasar. (Diperoleh dari IJavaObject)
IsEmpty	Mengembalikan jika ini Collection tidak berisi elemen. (Diperoleh dari ICollection)
JniIdentityHashCode	Mengembalikan nilai java.lang.System.identityHashCode() untuk instans yang dibungkus. (Diperoleh dari IJavaPeerable)
JniManagedPeerState	Status serekan terkelola. (Diperoleh dari IJavaPeerable)
JniPeerMembers	Akses anggota dan dukungan pemanggilan. (Diperoleh dari IJavaPeerable)
PeerReference	Mengembalikan instans objek Java yang dibungkus JniObjectReference . (Diperoleh dari IJavaPeerable)

Metode

Add(Object)	Menyisipkan elemen yang ditentukan ke dalam antrean ini jika memungkinkan untuk melakukannya segera tanpa melanggar batasan kapasitas, kembali true setelah berhasil dan melempar IllegalStateException jika saat ini tidak ada ruang yang tersedia.
AddAll(ICollection)	Menambahkan semua elemen dalam koleksi yang ditentukan ke koleksi ini (operasi opsional). (Diperoleh dari ICollection)
Clear()	Menghapus semua elemen dari koleksi ini (operasi opsional). (Diperoleh dari ICollection)
Contains(Object)	Mengembalikan true jika koleksi ini berisi elemen yang ditentukan. (Diperoleh dari ICollection)
ContainsAll(ICollection)	Mengembalikan true jika koleksi ini berisi semua elemen dalam koleksi yang ditentukan. (Diperoleh dari ICollection)
Disposed()	Dipanggil ketika instans telah dibuang. (Diperoleh dari IJavaPeerable)
DisposeUnlessReferenced()	Jika tidak ada referensi yang luar biasa untuk instans ini, maka panggilan Dispose(); jika tidak, tidak melakukan apa pun. (Diperoleh dari IJavaPeerable)
Element()	Mengambil, tetapi tidak menghapus, kepala antrean ini.
Equals(Object)	Membandingkan objek yang ditentukan dengan koleksi ini untuk kesetaraan. (Diperoleh dari ICollection)
Finalized()	Dipanggil ketika instans telah diselesaikan. (Diperoleh dari IJavaPeerable)
ForEach(IConsumer)	Melakukan tindakan yang diberikan untuk setiap elemen Iterable hingga semua elemen telah diproses atau tindakan melemparkan pengecualian. (Diperoleh dari IIterable)
GetHashCode()	Mengembalikan nilai kode hash untuk koleksi ini. (Diperoleh dari ICollection)
Iterator()	Mengembalikan iterator di atas elemen dalam koleksi ini. (Diperoleh dari ICollection)
Offer(Object)	Menyisipkan elemen yang ditentukan ke dalam antrean ini jika memungkinkan untuk segera melakukannya tanpa melanggar batasan kapasitas.
Peek()	Mengambil, tetapi tidak menghapus, kepala antrean ini, atau mengembalikan null jika antrean ini kosong.
Poll()	Mengambil dan menghapus kepala antrean ini, atau mengembalikan null jika antrean ini kosong.
Remove()	Mengambil dan menghapus kepala antrean ini.
Remove(Object)	Menghapus satu instans elemen yang ditentukan dari koleksi ini, jika ada (operasi opsional). (Diperoleh dari ICollection)
RemoveAll(ICollection)	Menghapus semua elemen koleksi ini yang juga terkandung dalam koleksi yang ditentukan (operasi opsional). (Diperoleh dari ICollection)
RemoveIf(IPredicate)	Menghapus semua elemen koleksi ini yang memenuhi predikat yang diberikan. (Diperoleh dari ICollection)
RetainAll(ICollection)	Hanya mempertahankan elemen dalam koleksi ini yang terkandung dalam koleksi yang ditentukan (operasi opsional). (Diperoleh dari ICollection)
SetJniIdentityHashCode(Int32)	Atur nilai yang dikembalikan oleh JniIdentityHashCode. (Diperoleh dari IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	Koleksi yang dirancang untuk menahan elemen sebelum diproses. (Diperoleh dari IJavaPeerable)
SetPeerReference(JniObjectReference)	Atur nilai yang dikembalikan oleh PeerReference. (Diperoleh dari IJavaPeerable)
Size()	Mengembalikan jumlah elemen dalam koleksi ini. (Diperoleh dari ICollection)
Spliterator()	Membuat lebih dari elemen yang Spliterator dijelaskan oleh ini Iterable. (Diperoleh dari IIterable)
ToArray()	Mengembalikan array yang berisi semua elemen dalam koleksi ini. (Diperoleh dari ICollection)
ToArray(IIntFunction)	Mengembalikan array yang berisi semua elemen dalam koleksi ini, menggunakan fungsi yang disediakan generator untuk mengalokasikan array yang dikembalikan. (Diperoleh dari ICollection)
ToArray(Object[])	Mengembalikan array yang berisi semua elemen dalam koleksi ini; jenis runtime array yang dikembalikan adalah array yang ditentukan. (Diperoleh dari ICollection)
UnregisterFromRuntime()	Batalkan pendaftaran instans ini sehingga runtime tidak akan mengembalikannya dari pemanggilan di masa mendatang Java.Interop.JniRuntime+JniValueManager.PeekValue . (Diperoleh dari IJavaPeerable)

Implementasi Antarmuka Eksplisit

IIterable.Spliterator()

Spliterator Membuat lebih dari elemen dalam koleksi ini. (Diperoleh dari ICollection)

Metode Ekstensi

JavaCast<TResult>(IJavaObject)	Melakukan konversi jenis yang diperiksa runtime Bahasa Umum Android.
JavaCast<TResult>(IJavaObject)	Koleksi yang dirancang untuk menahan elemen sebelum diproses.
GetJniTypeName(IJavaPeerable)	Koleksi yang dirancang untuk menahan elemen sebelum diproses.
ToEnumerable(IIterable)	Koleksi yang dirancang untuk menahan elemen sebelum diproses.
ToEnumerable<T>(IIterable)	Koleksi yang dirancang untuk menahan elemen sebelum diproses.