SpliteratorCharacteristics 列舉
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
指定分流器報告的來源及遍歷特性。
public enum SpliteratorCharacteristics
type SpliteratorCharacteristics =
- 繼承
-
SpliteratorCharacteristics
欄位
| 名稱 | 值 | Description |
|---|---|---|
| Distinct | 1 | 特徵值表示,對於遇到的每對元素 x, y, !x.等於(y)。 例如,這適用於基於集合的分割器。 |
| Sorted | 4 | 特徵值表示遭遇順序遵循定義的排序順序。 如果是這樣,getComparator() 方法會回傳相關的 Comparator,或者如果所有元素都是 Comparable,且依其自然排序,則為 Null。 一個報告已排序的分割器,也必須回報已排序。 |
| Ordered | 16 | 特徵值表示元素的遭遇順序已定義。 如果是這樣,這個分割器保證方法trySplit()會將嚴格的元素前綴拆分,tryAdvance(java.util.function.Consumer<? super T>)依前綴順序依序逐一步移動,且forEachRemaining(java.util.function.Consumer<?super T>)會依遭遇順序執行動作。 若對應的 Collection.iterator() 記錄一個訂單,則集合具有遭遇順序。 如果是這樣,遭遇順序和文件上的順序是一樣的。 否則,集合就沒有遭遇順序。 |
| Sized | 64 | 特徵值表示,estimateSize() 在遍歷或分割前回傳的值代表有限大小,且在結構源未改變的情況下,代表完整遍歷時會遇到元素數量的精確計數。 |
| Nonnull | 256 | 特徵值表示來源保證遇到的元素不會為空。 (例如,這適用於大多數並行的集合、佇列和映射。) |
| Immutable | 1024 | 特徵值表示元素來源無法結構性改變;也就是說,元素無法被新增、替換或移除,因此這些變更在遍歷過程中無法發生。 未報告不可變或同時的分割器,預期在穿越過程中會有文件化的政策(例如拋出 ConcurrentModificationException)來偵測結構干擾。 |
| Concurrent | 4096 | 特徵值表示元件來源可由多個執行緒安全同時修改(允許新增、替換及/或移除),無需外部同步。 若有,分流者應有關於穿越過程中修改影響的書面政策。 頂層分流器不應同時報告並行與大小,因為若已知有限大小,若來源在遍歷過程中同時修改,可能會改變。 此類分割器不一致,無法保證使用該分配器完成任何計算。 若子分割器已知子分割大小,且穿越時對源頭的新增或移除未被反映,子分流器可能會報告SSIZE。 頂層分割器不應同時報告 CONCURRENT 與 IMMUTABLE,因為它們是互斥的。 此類分割器不一致,無法保證使用該分配器完成任何計算。 若遍歷時對源的新增或移除未被反映,子分割器可能會報告 IMMUTABLE。 |
| Subsized | 16384 | 特徵值表示所有由 trySplit() 產生的分割器都會同時具有 SIZED 與 SUBSIZED。 (這表示所有子分割器,不論直接或間接,都會被 SSIZE 設定。)未依 SUBSIZED 要求報告 SIZED 的分割器即屬不一致,無法保證使用該分割器進行的任何計算。 |
備註
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。