INavigableSet 介面

定義

命名空間:

Java.Util

組件:

Mono.Android.dll

SortedSet A 擴展了導航方法，報告對特定搜尋目標的最接近匹配。

[Android.Runtime.Register("java/util/NavigableSet", "", "Java.Util.INavigableSetInvoker")]
[Java.Interop.JavaTypeParameters(new System.String[] { "E" })]
public interface INavigableSet : IDisposable, Java.Interop.IJavaPeerable, Java.Util.ISortedSet

[<Android.Runtime.Register("java/util/NavigableSet", "", "Java.Util.INavigableSetInvoker")>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "E" })>]
type INavigableSet = interface
    interface ISortedSet
    interface ISequencedSet
    interface ISequencedCollection
    interface ICollection
    interface IIterable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ISet

衍生

Java.Util.TreeSet

屬性

RegisterAttribute JavaTypeParametersAttribute

實作

IJavaObject IJavaPeerable IIterable ICollection ISequencedCollection ISequencedSet ISet ISortedSet IDisposable

備註

SortedSet A 擴展了導航方法，報告對特定搜尋目標的最接近匹配。 方法 #lower、 #floor、 #ceiling、 ， #higher 以及分別回傳小於、小於或等、大於或大於某個元素，若不存在該元素則回 null 傳。

NavigableSet A 可依升序或降序存取與遍歷。 該 #descendingSet 方法回傳集合的視圖，所有關聯與方向方法的意義都反轉。 向上操作與視圖的效能通常會比向下行更快。 此介面還定義了方法 #pollFirst ， #pollLast 若存在，則回傳並移除最低與最高元素，否則返回 null。 方法#subSet(Object, boolean, Object, boolean) subSet(E, boolean, E, boolean)、、、#headSet(Object, boolean) headSet(E, boolean)與同名#tailSet(Object, boolean) tailSet(E, boolean)方法的不同之處在於，接受額外參數來描述下界與上界是否包含SortedSet或排斥。 任意 NavigableSet 的子集必須實作該 NavigableSet 介面。

在允許 null 元素的實作中，導航方法的回傳值可能存在模糊性。 然而，即使在這種情況下，結果仍可透過檢查 contains(null)來消除歧義。 為避免此類問題，建議實作此介面時 <em>not</em> 允許插入 null 元素。 （注意，已排序的元素集合 Comparable 本質上不允許 null。）

方法#subSet(Object, Object) subSet(E, E)、、、#headSet(Object) headSet(E)被指定回傳#tailSet(Object) tailSet(E)，以便現有的實作SortedSet能夠相容地改編實作，SortedSet但鼓勵此介面的擴充與實作覆蓋這些方法返回NavigableSetNavigableSet。

新增於1.6版本。

的 java.util.NavigableSetJava 檔。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

屬性

名稱	Description
Handle	取得底層 Android 物件的 JNI 值。 (繼承來源 IJavaObject)
IsEmpty	若此集合沒有元素，則返回真。 (繼承來源 ISet)
JniIdentityHashCode	回傳包裹實例的 java.lang.System.identityHashCode() 值。 (繼承來源 IJavaPeerable)
JniManagedPeerState	管理貴族的狀況。 (繼承來源 IJavaPeerable)
JniObjectReferenceControlBlock	SortedSet A 擴展了導航方法，報告對特定搜尋目標的最接近匹配。 (繼承來源 IJavaPeerable)
JniPeerMembers	成員存取與召喚支援。 (繼承來源 IJavaPeerable)
PeerReference	回傳JniObjectReference包裹後的 Java 物件實例。 (繼承來源 IJavaPeerable)

方法

名稱	Description
Add(Object)	若指定元素尚未存在，則將該元素加入此集合（可選操作）。 (繼承來源 ISet)
AddAll(ICollection)	如果指定集合中尚未存在的所有元素，則將它們加入此集合（可選操作）。 (繼承來源 ISet)
AddFirst(Object)	新增一個元素作為此集合的第一個元素（可選操作）。 (繼承來源 ISequencedCollection)
AddLast(Object)	將元素加入為此集合的最後一個元素（可選操作）。 (繼承來源 ISequencedCollection)
Ceiling(Object)	回傳此集合中大於或等於該元素的最小元素，或 null 若不存在該元素則回傳。
Clear()	移除此集合中的所有元素（可選操作）。 (繼承來源 ISet)
Comparator()	回傳用於排序此集合元素的比較器，或 null 若此集合使用其元素的可比較自然排序，則回傳。 (繼承來源 ISortedSet)
Contains(Object)	若此集合包含指定元素，則回傳 true 。 (繼承來源 ISet)
ContainsAll(ICollection)	若此集合包含指定集合的所有元素，則回傳 true 。 (繼承來源 ISet)
DescendingIterator()	回傳該集合中元素的迭代器，依降序排列。
DescendingSet()	回傳此集合中元素的反序視圖。
Disposed()	當實例被處理後才被召喚。 (繼承來源 IJavaPeerable)
DisposeUnlessReferenced()	如果沒有未解決的參考資料，則 Dispose()呼叫;否則，則不做任何事。 (繼承來源 IJavaPeerable)
Equals(Object)	將指定的物件與此集合比較以求相等。 (繼承來源 ISet)
Finalized()	當實例完成後才會被通知。 (繼承來源 IJavaPeerable)
First()	回傳本組中目前第一個（最低）元素。 (繼承來源 ISortedSet)
Floor(Object)	回傳此集合中大小於或等於該元素的最大元素，或 null 若不存在該元素則回傳。
ForEach(IConsumer)	對每個元素 Iterable 執行指定動作，直到所有元素都處理完畢或動作拋出異常。 (繼承來源 IIterable)
GetFirst()	取得這個集合的第一個元素。 (繼承來源 ISequencedCollection)
GetHashCode()	回傳此集合的雜湊碼值。 (繼承來源 ISet)
GetLast()	拿到這個合集的最後一個元素。 (繼承來源 ISequencedCollection)
HeadSet(Object, Boolean)	回傳該集合中元素小於（或等於，若 inclusive 為真） toElement部分的視角。
HeadSet(Object)	待補充
Higher(Object)	返回此集合中嚴格大於該元素的最小元素，或 null 若不存在該元素則回傳。
Iterator()	回傳該集合中元素的迭代器，依序由高到低。
Last()	回傳本集合中目前最後（最高）元素。 (繼承來源 ISortedSet)
Lower(Object)	回傳此集合中嚴格小於給定元素的最大元素，或 null 若不存在該元素。
PollFirst()	擷取並移除第一個（最低）元素，若該集合為空則返回 null （可選操作）。
PollLast()	擷取並移除最後一個（最高）元素，若該集合為空則返回 null （可選操作）。
Remove(Object)	若該元素存在，則從此集合中移除該元素（可選操作）。 (繼承來源 ISet)
RemoveAll(ICollection)	從該集合中移除包含在指定集合中的所有元素（可選操作）。 (繼承來源 ISet)
RemoveFirst()	移除並回傳此集合的第一個元素（可選操作）。 (繼承來源 ISequencedCollection)
RemoveIf(IPredicate)	移除該集合中所有滿足該謂詞的元素（可選操作）。 (繼承來源 ICollection)
RemoveLast()	移除並回傳此集合的最後一個元素（可選操作）。 (繼承來源 ISequencedCollection)
RetainAll(ICollection)	僅保留該集合中包含於指定集合中的元素（可選操作）。 (繼承來源 ISet)
Reversed()	回傳此集合的逆序視圖。 (繼承來源 ISequencedCollection)
SetJniIdentityHashCode(Int32)	將回傳的值設為 JniIdentityHashCode。 (繼承來源 IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	SortedSet A 擴展了導航方法，報告對特定搜尋目標的最接近匹配。 (繼承來源 IJavaPeerable)
SetPeerReference(JniObjectReference)	將回傳的值設為 PeerReference。 (繼承來源 IJavaPeerable)
Size()	回傳該集合中的元素數（其基數）。 (繼承來源 ISet)
Spliterator()	在由此Spliterator描述的元素上建立 a Iterable 。 (繼承來源 IIterable)
SubSet(Object, Boolean, Object, Boolean)	回傳該集合中元素範圍從 fromElement 到 toElement的部分的視圖。
SubSet(Object, Object)	待補充
TailSet(Object, Boolean)	回傳該集合中元素大於（或等於，若 inclusive 為真） fromElement部分的視圖。
TailSet(Object)	待補充
ToArray()	回傳包含該集合中所有元素的陣列。 (繼承來源 ISet)
ToArray(IIntFunction)	回傳包含此集合中所有元素的陣列，並使用所提供的 generator 函式來分配回傳的陣列。 (繼承來源 ICollection)
ToArray(Object[])	回傳包含此集合中所有元素的陣列;回傳陣列的執行時型別即為指定陣列的類型。 (繼承來源 ISet)
UnregisterFromRuntime()	取消註冊此實例，讓執行時不會在未來 Java.Interop.JniRuntime+JniValueManager.PeekValue 的呼叫中回傳該實例。 (繼承來源 IJavaPeerable)

明確介面實作

名稱	Description
IIterable.Spliterator()	在這個排序集合中，建立 Spliterator 一個元素。 (繼承來源 ISortedSet)
ISequencedCollection.AddFirst(Object)	拋出 UnsupportedOperationException。 (繼承來源 ISortedSet)
ISequencedCollection.AddLast(Object)	拋出 UnsupportedOperationException。 (繼承來源 ISortedSet)
ISequencedCollection.GetFirst()	待補充 (繼承來源 ISortedSet)
ISequencedCollection.GetLast()	待補充 (繼承來源 ISortedSet)
ISequencedCollection.RemoveFirst()	待補充
ISequencedCollection.RemoveLast()	待補充
ISequencedCollection.Reversed()	待補充

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 self類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	SortedSet A 擴展了導航方法，報告對特定搜尋目標的最接近匹配。
ToEnumerable(IIterable)	回傳 和 IEnumerable ，會對 Java IIterable進行迭代，允許 foreach 和 LINQ 與 Java 集合類型一起使用。 每個元素都會從其 Java 實例編組到對應的受管理型別。
ToEnumerable<T>(IIterable)	回傳 和 IEnumerable<T> ，該 在 Java IIterable上迭代，將每個元素 集結為 T。 這使得 foreach LINQ 可以搭配 Java 集合類型一起使用。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。