ISpliterator Schnittstelle

Referenz

Definition

Namespace:: Java.Util

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ein Objekt zum Durchlaufen und Partitionieren von Elementen einer Quelle.

[Android.Runtime.Register("java/util/Spliterator", "", "Java.Util.ISpliteratorInvoker", ApiSince=24)]
[Java.Interop.JavaTypeParameters(new System.String[] { "T" })]
public interface ISpliterator : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("java/util/Spliterator", "", "Java.Util.ISpliteratorInvoker", ApiSince=24)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "T" })>]
type ISpliterator = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Abgeleitet: Java.Util.Spliterators.AbstractSpliterator

Attribute: RegisterAttribute JavaTypeParametersAttribute

Implementiert: IJavaObject IJavaPeerable IDisposable

Hinweise

Ein Objekt zum Durchlaufen und Partitionieren von Elementen einer Quelle. Die Quelle von Elementen, die von einem Spliterator abgedeckt werden, kann z. B. ein Array, ein CollectionE/A-Kanal oder eine Generatorfunktion sein.

Ein Spliterator kann Elemente einzeln (#tryAdvance tryAdvance()) oder sequenziell in Massen (#forEachRemaining forEachRemaining()) durchlaufen.

Ein Spliterator kann auch einige seiner Elemente (mit #trySplit) als ein anderer Spliterator partitionieren, um in möglicherweise parallelen Vorgängen verwendet zu werden. Vorgänge, die einen Spliterator verwenden, der nicht geteilt werden kann oder dies in hohem Maße unausgeglichen oder ineffizient ist, sind wahrscheinlich nicht von Parallelität profitieren. Durchqueren und Teilen von Auspuffelementen; Jeder Spliterator ist nur für eine einzelne Massenberechnung nützlich.

Ein Spliterator meldet auch eine Reihe von #characteristics() Strukturen, Quellen und Elementen aus , zwischen #ORDERED, #DISTINCT, , #SORTED, #SIZED, #NONNULL, , #IMMUTABLE, , #CONCURRENTund #SUBSIZED. Diese können von Spliterator-Clients eingesetzt werden, um die Berechnung zu steuern, zu spezialisieren oder zu vereinfachen. Beispielsweise würde ein Spliterator für einen Collection Bericht SIZED, ein Spliterator für einen Set Bericht DISTINCTund ein Spliterator für einen SortedSet Bericht auch berichten SORTED. Die Merkmale werden als einfaches unioniertes Bit-Set gemeldet.

Einige Merkmale beschränken zusätzlich das Verhalten der Methode; Wenn z. B ORDERED. die Traversalmethoden ihrer dokumentierten Reihenfolge entsprechen müssen. Neue Merkmale können in Zukunft definiert werden, sodass Implementierungen keine Bedeutungen für nicht aufgelistete Werte zuweisen sollten.

"Binding">Ein Spliterator, der c IMMUTABLE</c> oder <c>GLEICHZEITIG</c> nicht meldet<>, wird erwartet, dass eine dokumentierte Richtlinie zu folgendem Thema vorhanden ist: wenn der Spliterator an die Elementquelle bindet und die Erkennung struktureller Störungen der Elementquelle, die nach der Bindung erkannt wurde. Ein /em> Spliterator bindet an die Quelle von Elementen am Punkt des ersten Durchgangs, der ersten Unterbrechung oder der ersten Abfrage nach geschätzter Größe, anstatt zu dem Zeitpunkt, zu dem der Spliterator erstellt wird. Ein Spliterator, der nicht <spät>gebunden ist, bindet an die Quelle von Elementen an den Zeitpunkt der Konstruktion oder den ersten Aufruf einer Methode. Änderungen, die vor der Bindung an der Quelle vorgenommen wurden, werden angezeigt, wenn der Spliterator durchlaufen wird. Nach der Bindung sollte ein Spliterator auf best-effort-Basis ausgelöst ConcurrentModificationException werden, wenn strukturelle Störungen erkannt werden. Spliteratoren, die dies tun, werden als em>fail-fast bezeichnet<. Die Massendurchquerungsmethode (#forEachRemaining forEachRemaining()) eines Spliterators kann die Traversal- und Überprüfung auf strukturelle Störungen optimieren, nachdem alle Elemente durchlaufen wurden, anstatt die einzelnen Elemente zu überprüfen und sofort fehlschlagen zu müssen.

Spliteratoren können eine Schätzung der Anzahl der verbleibenden Elemente über die #estimateSize Methode bereitstellen. Im Idealfall entspricht dieser Wert genau der Anzahl der Elemente, #SIZEDdie bei einer erfolgreichen Durchquerung gefunden würden. Selbst wenn er nicht genau bekannt ist, kann ein geschätzter Wert jedoch dennoch für Vorgänge nützlich sein, die auf der Quelle ausgeführt werden, z. B. um festzustellen, ob es vorzuziehen ist, die verbleibenden Elemente sequenziell aufzuteilen oder zu durchlaufen.

Trotz ihres offensichtlichen Nutzens in parallelen Algorithmen werden Spliteratoren nicht erwartet, dass sie threadsicher sind; Stattdessen sollten Implementierungen paralleler Algorithmen mit Spliteratoren sicherstellen, dass der Spliterator jeweils nur von einem Thread verwendet wird. Dies ist im Allgemeinen leicht über <die>serielle Threadeinschränkung zu erreichen, was oft eine natürliche Folge typischer paralleler Algorithmen ist, die durch rekursive Dekomposition funktionieren. Ein Threadaufruf #trySplit() kann den zurückgegebenen Spliterator an einen anderen Thread übergeben, der wiederum den Spliterator durchlaufen oder weiter teilen kann. Das Verhalten von Splitting und Traversal ist nicht definiert, wenn zwei oder mehr Threads gleichzeitig auf demselben Spliterator arbeiten. Wenn der ursprüngliche Thread einen Spliterator zur Verarbeitung an einen anderen Thread ausgibt, ist es am besten, wenn diese Übergabe vor dem Verbrauch #tryAdvance(Consumer) tryAdvance()von Elementen erfolgt, da bestimmte Garantien (z. B. die Genauigkeit für #estimateSize()SIZED Spliteratoren) nur gültig sind, bevor die Durchquerung begonnen hat.

Primitive Untertypspezialisierungen werden Spliterator für OfInt int, OfLong longund OfDouble double Werte bereitgestellt. Die Standardimplementierungen des Untertyps und Spliterator#forEachRemaining(java.util.function.Consumer) der Spliterator#tryAdvance(java.util.function.Consumer) Feldgrundtypen für Instanzen ihrer entsprechenden Wrapperklasse. Solche Boxen können leistungsvorteile untergraben, die durch die Verwendung der Grundtypspezialisierungen gewonnen wurden. Um Boxen zu vermeiden, sollten die entsprechenden primitiven Methoden verwendet werden. Beispielsweise Spliterator.OfInt#tryAdvance(java.util.function.IntConsumer) sollte und Spliterator.OfInt#forEachRemaining(java.util.function.IntConsumer) sollte in den Einstellungen Spliterator.OfInt#tryAdvance(java.util.function.Consumer) und Spliterator.OfInt#forEachRemaining(java.util.function.Consumer). Durchqueren von grundtypischen Werten mithilfe von boxbasierten Methoden #tryAdvance tryAdvance() und #forEachRemaining(java.util.function.Consumer) forEachRemaining() wirkt sich nicht auf die Reihenfolge aus, in der die Werte, die in Boxwerte transformiert werden, gefunden werden.

Hinzugefügt in 1.8.

Java-Dokumentation für java.util.Spliterator.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Eigenschaften

Comparator	Wenn die Quelle `#SORTED` dieses Spliterators von einem `Comparator`, gibt dies `Comparator`zurück.
ExactSizeIfKnown	Convenience-Methode, die zurückgibt `#estimateSize()` , wenn dieser Spliterator ist `#SIZED`, sonst `-1`.
Handle	Ruft den JNI-Wert des zugrunde liegenden Android-Objekts ab. (Geerbt von IJavaObject)
JniIdentityHashCode	Gibt den Wert `java.lang.System.identityHashCode()` für die umbrochene Instanz zurück. (Geerbt von IJavaPeerable)
JniManagedPeerState	Status des verwalteten Peers. (Geerbt von IJavaPeerable)
JniPeerMembers	Mitgliedszugriff und Aufrufunterstützung. (Geerbt von IJavaPeerable)
PeerReference	Gibt eine JniObjectReference der umbrochenen Java-Objektinstanz zurück. (Geerbt von IJavaPeerable)

Methoden

Characteristics()	Gibt eine Reihe von Merkmalen dieses Spliterators und seiner Elemente zurück.
Disposed()	Wird aufgerufen, wenn die Instanz verworfen wurde. (Geerbt von IJavaPeerable)
DisposeUnlessReferenced()	Wenn keine offenen Verweise auf diese Instanz vorhanden sind, wird nichts aufgerufen `Dispose()`. Andernfalls wird nichts ausgeführt. (Geerbt von IJavaPeerable)
EstimateSize()	Gibt eine Schätzung der Anzahl der Elemente zurück, die von einem `#forEachRemaining` Traversal erkannt werden, oder gibt zurück `Long#MAX_VALUE` , wenn unendlich, unbekannt oder zu teuer zu berechnen ist.
Finalized()	Wird aufgerufen, wenn die Instanz abgeschlossen wurde. (Geerbt von IJavaPeerable)
ForEachRemaining(IConsumer)	Führt die angegebene Aktion für jedes verbleibende Element sequenziell im aktuellen Thread aus, bis alle Elemente verarbeitet wurden oder die Aktion eine Ausnahme auslöst.
HasCharacteristics(Int32)	Gibt zurück `true` , wenn dieser Spliterator `#characteristics` alle gegebenen Merkmale enthält.
SetJniIdentityHashCode(Int32)	Legen Sie den von `JniIdentityHashCode`. (Geerbt von IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	Ein Objekt zum Durchlaufen und Partitionieren von Elementen einer Quelle. (Geerbt von IJavaPeerable)
SetPeerReference(JniObjectReference)	Legen Sie den von `PeerReference`. (Geerbt von IJavaPeerable)
TryAdvance(IConsumer)	Wenn ein verbleibendes Element vorhanden ist, führt sie die angegebene Aktion aus, und gibt `true`zurück ; sonst wird zurückgegeben `false`.
TrySplit()	Wenn dieser Spliterator partitioniert werden kann, wird ein Spliterator zurückgegeben, der Elemente abdeckt, die auf der Rückgabe von dieser Methode nicht von diesem Spliterator abgedeckt werden.
UnregisterFromRuntime()	Heben Sie die Registrierung dieser Instanz auf, damit die Laufzeit sie nicht aus zukünftigen Java.Interop.JniRuntime+JniValueManager.PeekValue Aufrufen zurückgibt. (Geerbt von IJavaPeerable)

Erweiterungsmethoden

JavaCast<TResult>(IJavaObject)	Führt eine android-laufzeitgecheckte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Ein Objekt zum Durchlaufen und Partitionieren von Elementen einer Quelle.
GetJniTypeName(IJavaPeerable)	Ein Objekt zum Durchlaufen und Partitionieren von Elementen einer Quelle.

Gilt für:

Freigeben über