ISortedMap Antarmuka

Definisi

Ruang nama:: Java.Util

Rakitan:: Mono.Android.dll

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.

Map Yang selanjutnya menyediakan <total>pemesanan pada kuncinya.

[Android.Runtime.Register("java/util/SortedMap", "", "Java.Util.ISortedMapInvoker")]
[Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })]
public interface ISortedMap : IDisposable, Java.Interop.IJavaPeerable, Java.Util.IMap

[Android.Runtime.Register("java/util/SortedMap", "", "Java.Util.ISortedMapInvoker")]
[Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })]
public interface ISortedMap : IDisposable, Java.Interop.IJavaPeerable, Java.Util.ISequencedMap

[<Android.Runtime.Register("java/util/SortedMap", "", "Java.Util.ISortedMapInvoker")>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })>]
type ISortedMap = interface
    interface IMap
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

[<Android.Runtime.Register("java/util/SortedMap", "", "Java.Util.ISortedMapInvoker")>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })>]
type ISortedMap = interface
    interface IMap
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ISequencedMap

Turunan: Java.Util.INavigableMap

Java.Util.TreeMap

Atribut: RegisterAttribute JavaTypeParametersAttribute

Penerapan: IJavaObject IJavaPeerable IMap IDisposable ISequencedMap

Keterangan

Map Yang selanjutnya menyediakan <total>pemesanan pada kuncinya. Peta diurutkan sesuai dengan urutan alami yang sebanding dari kuncinya, atau oleh Comparator biasanya disediakan pada waktu pembuatan peta yang diurutkan. Urutan ini tercermin saat mengulangi tampilan koleksi peta yang diurutkan (dikembalikan oleh entrySetmetode , keySet dan values ). Beberapa operasi tambahan disediakan untuk memanfaatkan pemesanan. (Antarmuka ini adalah analog peta . SortedSet)

Semua kunci yang dimasukkan ke dalam peta yang diurutkan harus mengimplementasikan Comparable antarmuka (atau diterima oleh komparator yang ditentukan). Selain itu, semua kunci tersebut harus <>saling sebanding: k1.compareTo(k2) (atau comparator.compare(k1, k2)) tidak boleh melempar ClassCastException untuk kunci k1 apa pun dan k2 di peta yang diurutkan. Upaya untuk melanggar pembatasan ini akan menyebabkan metode atau pemanggilan konstruktor yang menyinggung melempar ClassCastException.

Perhatikan bahwa pengurutan yang dikelola oleh peta yang diurutkan (apakah komparator eksplisit disediakan atau tidak) harus <>konsisten dengan sama< dengan/em> jika peta yang diurutkan adalah untuk mengimplementasikan Map antarmuka dengan benar. (Lihat Comparable antarmuka atau Comparator antarmuka untuk definisi yang tepat dari yang konsisten dengan equals.) Ini karena Map antarmuka didefinisikan dalam hal equals operasi, tetapi peta yang diurutkan melakukan semua perbandingan kunci menggunakan metode (atau compare) -nya compareTo , sehingga dua kunci yang dianggap sama dengan metode ini adalah, dari sudut pemetaan yang diurutkan, sama. Perilaku peta <pohon em>didefinisikan>< dengan baik bahkan jika urutannya tidak konsisten dengan sama; itu hanya gagal mematuhi kontrak Map umum antarmuka.

Semua kelas implementasi peta yang diurutkan tujuan umum harus menyediakan empat konstruktor "standar". Tidak dimungkinkan untuk menerapkan rekomendasi ini meskipun sebagai konstruktor yang diperlukan tidak dapat ditentukan oleh antarmuka. Konstruktor "standar" yang diharapkan untuk semua implementasi peta yang diurutkan adalah: <konstruktor ol><li>A batal (tanpa argumen), yang membuat peta yang diurutkan kosong yang diurutkan sesuai dengan urutan alami kuncinya.</li li>><Konstruktor dengan satu argumen jenis Comparator, yang membuat peta yang diurutkan kosong diurutkan sesuai dengan komparator yang ditentukan.</li li>><Konstruktor dengan satu argumen jenis Map, yang membuat peta baru dengan pemetaan nilai kunci yang sama dengan argumennya, diurutkan sesuai dengan urutan alami kunci.</li><li>Konstruktor dengan satu argumen jenis SortedMap, yang membuat peta yang diurutkan baru dengan pemetaan nilai kunci yang sama dan pengurutan yang sama dengan peta input yang diurutkan.</li></ol>

< >Catatan< kuat/kuat>: beberapa metode mengembalikan submap dengan rentang kunci terbatas. Rentang seperti itu adalah setengah terbuka, yaitu, mereka menyertakan titik akhir rendah mereka tetapi bukan titik akhir tinggi mereka (jika berlaku). Jika Anda memerlukan <>rentang tertutup em (yang mencakup kedua titik akhir), dan jenis kunci memungkinkan perhitungan penerus kunci tertentu, hanya meminta subrange dari lowEndpoint ke successor(highEndpoint). Misalnya, misalkan itu m adalah peta yang kuncinya adalah string. Idiom berikut memperoleh tampilan yang berisi semua pemetaan nilai kunci yang m kuncinya antara low dan high, inklusif:

SortedMap<String, V> sub = m.subMap(low, high+"\0");

Teknik serupa dapat digunakan untuk menghasilkan <>rentang< terbuka/em> (yang tidak berisi titik akhir). Idiom berikut mendapatkan tampilan yang berisi semua pemetaan nilai kunci yang m kuncinya antara low dan high, eksklusif:

SortedMap<String, V> sub = m.subMap(low+"\0", high);

Antarmuka ini adalah anggota Java Collections Framework.

Ditambahkan dalam 1.2.

Java dokumentasi untuk java.util.SortedMap.

Bagian dari halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Android Open Source Project dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Creative Commons 2.5 Lisensi Atribusi.

Properti

Nama	Deskripsi
Handle	Mendapatkan nilai JNI dari objek Android yang mendasar. (Diperoleh dari IJavaObject)
IsEmpty	Mengembalikan apakah peta ini kosong. (Diperoleh dari IMap)
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 dibungkusJniObjectReference. (Diperoleh dari IJavaPeerable)

Metode

Nama	Deskripsi
Clear()	Menghapus semua pemetaan dari peta ini (operasi opsional). (Diperoleh dari IMap)
Comparator()	Mengembalikan komparator yang digunakan untuk mengurutkan kunci dalam peta ini, atau `null` jika peta ini menggunakan urutan alami yang sebanding dari kuncinya.
Compute(Object, IBiFunction)	Mencoba menghitung pemetaan untuk kunci yang ditentukan dan nilai yang dipetakan saat ini (atau `null` jika tidak ada pemetaan saat ini). (Diperoleh dari IMap)
ComputeIfAbsent(Object, IFunction)	Jika kunci yang ditentukan belum dikaitkan dengan nilai (atau dipetakan ke `null`), upaya untuk menghitung nilainya menggunakan fungsi pemetaan yang diberikan dan memasukkannya ke dalam peta ini kecuali `null`. (Diperoleh dari IMap)
ComputeIfPresent(Object, IBiFunction)	Jika nilai untuk kunci yang ditentukan ada dan non-null, upaya untuk menghitung pemetaan baru yang diberikan kunci dan nilai yang dipetakan saat ini. (Diperoleh dari IMap)
ContainsKey(Object)	Mengembalikan `true` jika peta ini berisi pemetaan untuk kunci yang ditentukan. (Diperoleh dari IMap)
ContainsValue(Object)	Mengembalikan `true` jika peta ini memetakan satu atau beberapa kunci ke nilai yang ditentukan. (Diperoleh dari IMap)
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)
EntrySet()	Mengembalikan `Set` tampilan pemetaan yang terkandung dalam peta ini.
Equals(Object)	Membandingkan objek yang ditentukan dengan peta ini untuk kesetaraan. (Diperoleh dari IMap)
Finalized()	Dipanggil ketika instans telah diselesaikan. (Diperoleh dari IJavaPeerable)
FirstEntry()	`Map` Yang selanjutnya menyediakan <total>pemesanan</em> pada kuncinya. (Diperoleh dari ISequencedMap)
FirstKey()	Mengembalikan kunci pertama (terendah) yang saat ini ada di peta ini.
ForEach(IBiConsumer)	Melakukan tindakan yang diberikan untuk setiap entri dalam peta ini hingga semua entri telah diproses atau tindakan melemparkan pengecualian. (Diperoleh dari IMap)
Get(Object)	Mengembalikan nilai yang kunci yang ditentukan dipetakan, atau `null` jika peta ini tidak berisi pemetaan untuk kunci. (Diperoleh dari IMap)
GetHashCode()	Mengembalikan nilai kode hash untuk peta ini. (Diperoleh dari IMap)
GetOrDefault(Object, Object)	Mengembalikan nilai yang kunci yang ditentukan dipetakan, atau `defaultValue` jika peta ini tidak berisi pemetaan untuk kunci. (Diperoleh dari IMap)
HeadMap(Object)	Mengembalikan tampilan bagian dari peta ini yang kuncinya benar-benar kurang dari `toKey`.
KeySet()	Mengembalikan `Set` tampilan kunci yang terkandung dalam peta ini.
LastEntry()	`Map` Yang selanjutnya menyediakan <total>pemesanan</em> pada kuncinya. (Diperoleh dari ISequencedMap)
LastKey()	Mengembalikan kunci terakhir (tertinggi) yang saat ini ada di peta ini.
Merge(Object, Object, IBiFunction)	Jika kunci yang ditentukan belum dikaitkan dengan nilai atau dikaitkan dengan null, kaitkan dengan nilai non-null yang diberikan. (Diperoleh dari IMap)
PollFirstEntry()	`Map` Yang selanjutnya menyediakan <total>pemesanan</em> pada kuncinya. (Diperoleh dari ISequencedMap)
PollLastEntry()	`Map` Yang selanjutnya menyediakan <total>pemesanan</em> pada kuncinya. (Diperoleh dari ISequencedMap)
Put(Object, Object)	Mengaitkan nilai yang ditentukan dengan kunci yang ditentukan dalam peta ini (operasi opsional). (Diperoleh dari IMap)
PutAll(IDictionary)	Menyalin semua pemetaan dari peta yang ditentukan ke peta ini (operasi opsional). (Diperoleh dari IMap)
PutFirst(Object, Object)	Menyisipkan pemetaan yang diberikan ke dalam peta jika belum ada, atau mengganti nilai pemetaan jika sudah ada (operasi opsional). (Diperoleh dari ISequencedMap)
PutIfAbsent(Object, Object)	Jika kunci yang ditentukan belum dikaitkan dengan nilai (atau dipetakan ke `null`) mengaitkannya dengan nilai yang diberikan dan mengembalikan `null`, jika tidak mengembalikan nilai saat ini. (Diperoleh dari IMap)
PutLast(Object, Object)	Menyisipkan pemetaan yang diberikan ke dalam peta jika belum ada, atau mengganti nilai pemetaan jika sudah ada (operasi opsional). (Diperoleh dari ISequencedMap)
Remove(Object, Object)	Menghapus entri untuk kunci yang ditentukan hanya jika saat ini dipetakan ke nilai yang ditentukan. (Diperoleh dari IMap)
Remove(Object)	Menghapus pemetaan untuk kunci dari peta ini jika ada (operasi opsional). (Diperoleh dari IMap)
Replace(Object, Object, Object)	Mengganti entri untuk kunci yang ditentukan hanya jika saat ini dipetakan ke nilai yang ditentukan. (Diperoleh dari IMap)
Replace(Object, Object)	Mengganti entri untuk kunci yang ditentukan hanya jika saat ini dipetakan ke beberapa nilai. (Diperoleh dari IMap)
ReplaceAll(IBiFunction)	Mengganti nilai setiap entri dengan hasil pemanggilan fungsi yang diberikan pada entri tersebut sampai semua entri telah diproses atau fungsi melemparkan pengecualian. (Diperoleh dari IMap)
Reversed()	Mengembalikan tampilan peta ini yang diurutkan terbalik. (Diperoleh dari ISequencedMap)
SequencedEntrySet()	`SequencedSet` Mengembalikan tampilan peta `#entrySet entrySet`ini . (Diperoleh dari ISequencedMap)
SequencedKeySet()	`SequencedSet` Mengembalikan tampilan peta `#keySet keySet`ini . (Diperoleh dari ISequencedMap)
SequencedValues()	Mengembalikan `SequencedCollection` tampilan koleksi peta `#values values` ini. (Diperoleh dari ISequencedMap)
SetJniIdentityHashCode(Int32)	Atur nilai yang dikembalikan oleh `JniIdentityHashCode`. (Diperoleh dari IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	`Map` Yang selanjutnya menyediakan <total>pemesanan</em> pada kuncinya. (Diperoleh dari IJavaPeerable)
SetPeerReference(JniObjectReference)	Atur nilai yang dikembalikan oleh `PeerReference`. (Diperoleh dari IJavaPeerable)
Size()	Mengembalikan jumlah pemetaan nilai kunci dalam peta ini. (Diperoleh dari IMap)
SubMap(Object, Object)	Mengembalikan tampilan bagian peta ini yang kuncinya berkisar dari `fromKey`, inklusif, hingga `toKey`, eksklusif.
TailMap(Object)	Mengembalikan tampilan bagian dari peta ini yang kuncinya lebih besar dari atau sama dengan `fromKey`.
UnregisterFromRuntime()	Batalkan pendaftaran instans ini sehingga runtime tidak akan mengembalikannya dari pemanggilan di masa mendatang Java.Interop.JniRuntime+JniValueManager.PeekValue . (Diperoleh dari IJavaPeerable)
Values()	Mengembalikan tampilan nilai yang `Collection` terkandung dalam peta ini.

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
ISequencedMap.PutFirst(Object, Object)	Melemparkan `UnsupportedOperationException`.
ISequencedMap.PutLast(Object, Object)	Melemparkan `UnsupportedOperationException`.
ISequencedMap.Reversed()	`Map` Yang selanjutnya menyediakan <total>pemesanan</em> pada kuncinya.

Metode Ekstensi

Nama	Deskripsi
GetJniTypeName(IJavaPeerable)	Mendapatkan nama JNI dari jenis instans `self`.
JavaAs<TResult>(IJavaPeerable)	Cobalah untuk memaksa `self` untuk mengetik `TResult`, memeriksa bahwa paksaan valid di sisi Java.
JavaCast<TResult>(IJavaObject)	Melakukan konversi jenis yang diperiksa runtime Android.
JavaCast<TResult>(IJavaObject)	`Map` Yang selanjutnya menyediakan <total>pemesanan</em> pada kuncinya.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Cobalah untuk memaksa `self` untuk mengetik `TResult`, memeriksa bahwa paksaan valid di sisi Java.

Berlaku untuk