ISortedSet 介面
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
, Set
進一步提供其元素 的總排序 。
[Android.Runtime.Register("java/util/SortedSet", "", "Java.Util.ISortedSetInvoker")]
[Java.Interop.JavaTypeParameters(new System.String[] { "E" })]
public interface ISortedSet : IDisposable, Java.Interop.IJavaPeerable, Java.Util.ISet
[<Android.Runtime.Register("java/util/SortedSet", "", "Java.Util.ISortedSetInvoker")>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "E" })>]
type ISortedSet = interface
interface ISet
interface ICollection
interface IIterable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- 衍生
- 屬性
- 實作
備註
, Set
進一步提供其元素 的總排序 。 元素會使用其「可比較」的自然順序來排序,或通常是在 Comparator
排序的集合建立時間提供。 集合的反覆運算器會以遞增元素順序周遊集合。 提供數個額外的作業來利用訂購。 (此介面是 .) 的 SortedMap
設定類比
插入排序集的所有元素都必須實 Comparable
作介面 (,或由指定的比較子接受) 。 此外,所有這類元素都必須 相互比較: e1.compareTo(e2)
(或 comparator.compare(e1, e2)
) 不得擲回 ClassCastException
任何元素 e1
和 e2
已排序集合中的 。 嘗試違反此限制會導致違規的方法或建構函式調用擲 ClassCastException
回 。
請注意,排序集所維護的順序 (是否提供明確的比較子,如果排序集正確實 Set
作介面,則) 必須與等號一致。 (請參閱 Comparable
介面或 Comparator
介面,以取得 與 equals.) 一致之精確定義的介面。這是因為 Set
介面是以作業方式 equals
定義,但已排序的集合會使用其 compareTo
(或 compare
) 方法來執行所有專案比較,因此此方法視為相等的兩個元素是從排序集的觀點來看, 平等。 即使排序次序不一致, 排序集的行為 也會妥善定義;它只是無法遵守介面的 Set
一般合約。
所有一般用途的排序集實作類別都應該提供四個「標準」建構函式:1) A void (沒有引數) 建構函式,這會根據其元素的自然順序建立空的排序集。 2) 具有型 Comparator
別單一引數的建構函式,它會根據指定的比較子建立已排序的空排序集。 3) 具有型 Collection
別單一引數的建構函式,它會使用與其引數相同的元素建立新的排序集,並根據專案的自然順序排序。 4) 類型為 單一引數的 SortedSet
建構函式,它會建立具有相同元素的新排序集,以及與輸入排序集相同的順序。 無法強制執行此建議,因為介面不能包含建構函式。
注意:數種方法會傳回具有限制範圍的子集。 這類範圍是 半開啟的,也就是說,它們包含其低端點,但不包含其高端點, (適用的) 。 如果您需要包含兩個端點) 的 封閉範圍 (,而且元素類型允許計算指定值的後續任務,只要求子範圍從 lowEndpoint
到 successor(highEndpoint)
。 例如,假設 s
是一組已排序的字串。 下列慣用語會取得包含 中所有字串 s
的檢視,包含 : low
high
SortedSet<String> sub = s.subSet(low, high+"\0");
類似的技術可用來產生 開放式範圍 (,其中不包含兩個端點) 。 下列慣用語會取得包含 中 s
所有 Strings 的 low
high
檢視,其為 獨佔:
SortedSet<String> sub = s.subSet(low+"\0", high);
這個介面是 JAVA Collections Framework的成員。
已在 1.2 中新增。
此頁面的部分是根據 原始碼專案所建立和共用的工作進行修改,並根據中所述的詞彙使用。
屬性
Handle |
取得基礎 Android 物件的 JNI 值。 (繼承來源 IJavaObject) |
IsEmpty |
如果這個集合沒有元素,則傳回 true。 (繼承來源 ISet) |
JniIdentityHashCode |
傳回包裝實例的 |
JniManagedPeerState |
受控對等的狀態。 (繼承來源 IJavaPeerable) |
JniPeerMembers |
成員存取和調用支援。 (繼承來源 IJavaPeerable) |
PeerReference |
傳 JniObjectReference 回已包裝 JAVA 物件實例的 。 (繼承來源 IJavaPeerable) |
方法
Add(Object) |
如果指定的元素尚未存在, (選擇性作業) ,請將指定的元素加入至此集合。 (繼承來源 ISet) |
AddAll(ICollection) |
如果指定集合中的所有元素尚未存在,請將指定集合中的所有元素新增至此集合, (選擇性作業) 。 (繼承來源 ISet) |
Clear() |
從此集合中移除所有元素, (選擇性作業) 。 (繼承來源 ISet) |
Comparator() |
傳回用來排序這個集合中專案的比較子,或者 |
Contains(Object) |
|
ContainsAll(ICollection) |
|
Disposed() |
在處置實例時呼叫。 (繼承來源 IJavaPeerable) |
DisposeUnlessReferenced() |
如果沒有這個實例的未完成參考,則呼叫 |
Equals(Object) |
比較指定的 物件與這個集合是否相等。 (繼承來源 ISet) |
Finalized() |
實例完成時呼叫。 (繼承來源 IJavaPeerable) |
First() |
傳回目前在此集合中的第一個 (最低) 元素。 |
ForEach(IConsumer) |
針對 的每個元素執行指定的動作,直到所有專案 |
GetHashCode() |
傳回這個集合的雜湊碼值。 (繼承來源 ISet) |
HeadSet(Object) |
傳回這個集合部分的檢視,其元素嚴格小於 |
Iterator() |
傳回這個集合中元素的反覆運算器。 (繼承來源 ISet) |
Last() |
傳回此集合中目前最高) 元素的最後一個 (。 |
Remove(Object) |
如果指定的元素存在 (選擇性作業) ,則會從這個集合中移除指定的元素。 (繼承來源 ISet) |
RemoveAll(ICollection) |
從這個集合中移除包含在指定集合中的所有元素, (選擇性作業) 。 (繼承來源 ISet) |
RemoveIf(IPredicate) |
移除滿足指定述詞之這個集合的所有專案。 (繼承來源 ICollection) |
RetainAll(ICollection) |
僅保留此集合中所包含的元素, (選擇性作業) 。 (繼承來源 ISet) |
SetJniIdentityHashCode(Int32) |
設定 所 |
SetJniManagedPeerState(JniManagedPeerStates) |
, |
SetPeerReference(JniObjectReference) |
設定 所 |
Size() |
傳回此集合中的元素數目, (其基數) 。 (繼承來源 ISet) |
Spliterator() |
|
SubSet(Object, Object) |
傳回這個集合之部分的檢視,其元素範圍從 |
TailSet(Object) |
傳回這個集合之部分的檢視,其專案大於或等於 |
ToArray() |
傳回陣列,其中包含此集合中的所有專案。 (繼承來源 ISet) |
ToArray(IIntFunction) |
傳回陣列,其中包含這個集合中的所有專案,使用提供的 |
ToArray(Object[]) |
傳回陣列,其中包含此集合中的所有專案;傳回之陣列的執行時間類型是指定之陣列的執行時間類型。 (繼承來源 ISet) |
UnregisterFromRuntime() |
取消註冊此實例,讓執行時間不會從未來的 Java.Interop.JniRuntime+JniValueManager.PeekValue 調用傳回它。 (繼承來源 IJavaPeerable) |
明確介面實作
IIterable.Spliterator() |
|
擴充方法
JavaCast<TResult>(IJavaObject) |
執行 Android 執行時間檢查的類型轉換。 |
JavaCast<TResult>(IJavaObject) |
, |
GetJniTypeName(IJavaPeerable) |
, |
ToEnumerable(IIterable) |
, |
ToEnumerable<T>(IIterable) |
, |