INavigableMap 介面
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
SortedMap A 擴展了導航方法，回傳給定搜尋目標的最接近匹配點。
[Android.Runtime.Register("java/util/NavigableMap", "", "Java.Util.INavigableMapInvoker")]
[Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })]
public interface INavigableMap : IDisposable, Java.Interop.IJavaPeerable, Java.Util.ISortedMap[<Android.Runtime.Register("java/util/NavigableMap", "", "Java.Util.INavigableMapInvoker")>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })>]
type INavigableMap = interface
interface ISortedMap
interface IMap
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface ISequencedMap- 衍生
- 屬性
- 實作
備註
SortedMap A 擴展了導航方法，回傳給定搜尋目標的最接近匹配點。
#lowerEntry方法、#floorEntry、#ceilingEntry#higherEntry、與與鍵值相關的物件分別回傳Map.Entry小於、小於或相等、大於或大於某一鍵，若不存在則回null傳。 同理，方法#lowerKey、#floorKey、#ceilingKey#higherKey僅回傳對應的鍵。 所有這些方法都是為了定位而非遍歷條目。
NavigableMap A 鍵可以以升序或降序進入並遍歷。 該 #descendingMap 方法回傳一個映射視圖，所有關聯與方向方法的意義都反轉。 向上操作與視圖的效能通常會比向下行更快。 方法#subMap(Object, boolean, Object, boolean) subMap(K, boolean, K, boolean)、、、#headMap(Object, boolean) headMap(K, boolean)與同名#tailMap(Object, boolean) tailMap(K, boolean)方法的不同之處在於，接受額外參數來描述下界與上界是否包含SortedMap或排斥。 任何 NavigableMap 子映射都必須實作該 NavigableMap 介面。
此介面還定義方法#firstEntry、#pollFirstEntry#lastEntry#pollLastEntry，並返回和/或移除最小與最大映射（若存在）;否則返回。null
方法#ceilingEntry、#firstEntry、#floorEntry、#higherEntry#lastEntry#lowerEntry#pollFirstEntry#pollLastEntry回傳Map.Entry代表呼叫時映射快照的實例。 他們做 <em>not</em> 支持透過可選 Map.Entry#setValue setValue 方法突變底層映射。
方法#subMap(Object, Object) subMap(K, K)、、、#headMap(Object) headMap(K)被指定回傳#tailMap(Object) tailMap(K)，以便現有的實作SortedMap能夠相容地改編實作，SortedMap但鼓勵此介面的擴充與實作覆蓋這些方法返回NavigableMapNavigableMap。 同理， #keySet() 可覆寫為返回 NavigableSet。
新增於1.6版本。
的 java.util.NavigableMapJava 檔。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
屬性
| 名稱 | Description |
|---|---|
| Handle |
取得底層 Android 物件的 JNI 值。 (繼承來源 IJavaObject) |
| IsEmpty |
回傳此映射是否為空。 (繼承來源 IMap) |
| JniIdentityHashCode |
回傳包裹實例的 |
| JniManagedPeerState |
管理貴族的狀況。 (繼承來源 IJavaPeerable) |
| JniObjectReferenceControlBlock |
|
| JniPeerMembers |
成員存取與召喚支援。 (繼承來源 IJavaPeerable) |
| PeerReference |
回傳JniObjectReference包裹後的 Java 物件實例。 (繼承來源 IJavaPeerable) |
方法
| 名稱 | Description |
|---|---|
| CeilingEntry(Object) |
回傳一個與大於或等於該鍵的最小鍵相關聯的鍵值映射，或 |
| CeilingKey(Object) |
回傳大於或等於給定鍵的最小鍵，或 |
| Clear() |
移除此映射中的所有映射（可選操作）。 (繼承來源 IMap) |
| Comparator() |
回傳用於排序此映射中鍵鍵的比較器，或 |
| Compute(Object, IBiFunction) |
嘗試計算指定鍵及其目前映射值的映射，或 |
| ComputeIfAbsent(Object, IFunction) |
若指定的鍵尚未與某值相關聯（或映射至 |
| ComputeIfPresent(Object, IBiFunction) |
若指定鍵值存在且非空值，則嘗試根據該鍵及其當前映射值計算新的映射（可選操作）。 (繼承來源 IMap) |
| ContainsKey(Object) |
若此映射包含指定鍵的映射，則回傳 |
| ContainsValue(Object) |
若此映射將一個或多個鍵對應到指定值，則回傳 |
| DescendingKeySet() |
回傳此映射中金鑰的反序 |
| DescendingMap() |
回傳此映射中映射的反序視圖。 |
| Disposed() |
當實例被處理後才被召喚。 (繼承來源 IJavaPeerable) |
| DisposeUnlessReferenced() |
如果沒有未解決的參考資料，則 |
| EntrySet() |
回傳 |
| Equals(Object) |
將指定物件與此映射比較以求相等。 (繼承來源 IMap) |
| Finalized() |
當實例完成後才會被通知。 (繼承來源 IJavaPeerable) |
| FirstEntry() |
回傳與該映射中最小鍵相關聯的鍵值映射，或 |
| FirstKey() |
回傳此地圖目前第一個（最低）鍵。 (繼承來源 ISortedMap) |
| FloorEntry(Object) |
回傳與大小於該鍵的最大鍵相關聯的鍵值映射，或 |
| FloorKey(Object) |
回傳小於或等於給定鍵的最大鍵，或 |
| ForEach(IBiConsumer) |
對該映射中的每個項目執行指定動作，直到所有項目都處理完畢或該動作拋出例外。 (繼承來源 IMap) |
| Get(Object) |
回傳指定金鑰所映射的值，或 |
| GetHashCode() |
回傳此映射的雜湊碼值。 (繼承來源 IMap) |
| GetOrDefault(Object, Object) |
回傳指定金鑰所映射的值，或 |
| HeadMap(Object, Boolean) |
回傳該映射中鍵數小於（或等於，若 |
| HeadMap(Object) |
待補充 |
| HigherEntry(Object) |
回傳一個與嚴格大於給定鍵的最小鍵相關的鍵值映射，或 |
| HigherKey(Object) |
回傳嚴格大於給定鍵的最小鍵，或 |
| KeySet() |
回傳 |
| LastEntry() |
回傳與該映射中最大鍵相關聯的鍵值映射，或 |
| LastKey() |
回傳目前該地圖中最後（最高）的鍵。 (繼承來源 ISortedMap) |
| LowerEntry(Object) |
回傳與嚴格小於給定鍵的最大鍵相關的鍵值映射，或 |
| LowerKey(Object) |
回傳嚴格小於給定金鑰的最大金鑰，或 |
| Merge(Object, Object, IBiFunction) |
如果指定的鍵尚未與某值相關聯或與空值相關聯，則會將其與給定的非空值關聯（可選操作）。 (繼承來源 IMap) |
| NavigableKeySet() |
回傳 |
| PollFirstEntry() |
移除並回傳與該映射中最小鍵相關聯的鍵值映射，或 |
| PollLastEntry() |
移除並回傳與該映射中最大鍵相關聯的鍵值映射，或 |
| Put(Object, Object) |
將指定值與此映射中的指定鍵鍵關聯（可選操作）。 (繼承來源 IMap) |
| PutAll(IDictionary) |
將指定映射中的所有映射複製到該映射（可選操作）。 (繼承來源 IMap) |
| PutFirst(Object, Object) |
若該映射尚未存在，則插入該映射;若映射已存在，則替換該映射值（可選操作）。 (繼承來源 ISequencedMap) |
| PutIfAbsent(Object, Object) |
如果指定的鍵尚未與某值相關聯（或映射到 |
| PutLast(Object, Object) |
若該映射尚未存在，則插入該映射;若映射已存在，則替換該映射值（可選操作）。 (繼承來源 ISequencedMap) |
| Remove(Object, Object) |
只有當指定鍵目前已映射到指定值時，才會移除該欄位（可選操作）。 (繼承來源 IMap) |
| Remove(Object) |
若該映射存在，則移除該映射（可選操作）。 (繼承來源 IMap) |
| Replace(Object, Object, Object) |
只有當指定鍵目前映射到指定值時，才會替換該指定鍵的條目（可選操作）。 (繼承來源 IMap) |
| Replace(Object, Object) |
只有當指定鍵目前映射到某個值時，才會替換該金鑰的條目（可選操作）。 (繼承來源 IMap) |
| ReplaceAll(IBiFunction) |
將每個項目的值替換為呼叫該該項目的結果，直到所有項目都處理完畢或該函式拋出例外（可選操作）。 (繼承來源 IMap) |
| Reversed() |
回傳此映射的反序視圖。 (繼承來源 ISequencedMap) |
| SequencedEntrySet() |
回傳 |
| SequencedKeySet() |
回傳 |
| SequencedValues() |
回傳 |
| SetJniIdentityHashCode(Int32) |
將回傳的值設為 |
| SetJniManagedPeerState(JniManagedPeerStates) |
|
| SetPeerReference(JniObjectReference) |
將回傳的值設為 |
| Size() |
回傳此映射中鍵值映射的數量。 (繼承來源 IMap) |
| SubMap(Object, Boolean, Object, Boolean) |
回傳該映射中鍵值從 |
| SubMap(Object, Object) |
待補充 |
| TailMap(Object, Boolean) |
回傳該映射中鍵值大於（或等於，若 |
| TailMap(Object) |
待補充 |
| UnregisterFromRuntime() |
取消註冊此實例，讓執行時不會在未來 Java.Interop.JniRuntime+JniValueManager.PeekValue 的呼叫中回傳該實例。 (繼承來源 IJavaPeerable) |
| Values() |
回傳 |
明確介面實作
| 名稱 | Description |
|---|---|
| ISequencedMap.PutFirst(Object, Object) |
拋出 |
| ISequencedMap.PutLast(Object, Object) |
拋出 |
| ISequencedMap.Reversed() |
待補充 |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時間檢查的類型轉換。 |
| JavaCast<TResult>(IJavaObject) |
|
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |