IQueue Antarmuka
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
- Atribut
- Penerapan
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 |
JniIdentityHashCode |
Mengembalikan nilai |
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 |
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 |
ContainsAll(ICollection) |
Mengembalikan |
Disposed() |
Dipanggil ketika instans telah dibuang. (Diperoleh dari IJavaPeerable) |
DisposeUnlessReferenced() |
Jika tidak ada referensi yang luar biasa untuk instans ini, maka panggilan |
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 |
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 |
Poll() |
Mengambil dan menghapus kepala antrean ini, atau mengembalikan |
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 |
SetJniManagedPeerState(JniManagedPeerStates) |
Koleksi yang dirancang untuk menahan elemen sebelum diproses. (Diperoleh dari IJavaPeerable) |
SetPeerReference(JniObjectReference) |
Atur nilai yang dikembalikan oleh |
Size() |
Mengembalikan jumlah elemen dalam koleksi ini. (Diperoleh dari ICollection) |
Spliterator() |
Membuat lebih dari elemen yang |
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 |
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() |
|
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. |