CollationElementIterator Klasse
Definition
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.
CollationElementIterator ist ein Iterator, der von einem RuleBasedCollator erstellt wird, um eine Zeichenfolge zu durchlaufen.
[Android.Runtime.Register("android/icu/text/CollationElementIterator", ApiSince=24, DoNotGenerateAcw=true)]
public sealed class CollationElementIterator : Java.Lang.Object[<Android.Runtime.Register("android/icu/text/CollationElementIterator", ApiSince=24, DoNotGenerateAcw=true)>]
type CollationElementIterator = class
inherit Object- Vererbung
- Attribute
Hinweise
CollationElementIterator ist ein Iterator, der von einem RuleBasedCollator erstellt wird, um eine Zeichenfolge zu durchlaufen. Das Rückgabeergebnis jeder Iteration ist ein 32-Bit-Sortierelement (CE), das die Sortierpriorität des nächsten Zeichens oder der Abfolge von Zeichen in der Quellzeichenfolge definiert.
Betrachten Sie zur Veranschaulichung folgendes in Slowakisch und in der traditionellen spanischen Sortierung: <Blockquote>
"ca" -> the first collation element is CE('c') and the second
collation element is CE('a').
"cha" -> the first collation element is CE('ch') and the second
collation element is CE('a').
</blockquote> Und in deutscher Phonebook-Sortierung, <Blockquote>
Since the character 'æ' is a composed character of 'a' and 'e', the
iterator returns two collation elements for the single character 'æ'
"æb" -> the first collation element is collation_element('a'), the
second collation element is collation_element('e'), and the
third collation element is collation_element('b').
</blockquote>
Bei Sortierungssortierungsvergleichen können die Ergebnisse des Sortierungselements nicht einfach mit einfachen arithmetischen Operatoren verglichen werden, z. B. mit <, == oder >, muss eine weitere Verarbeitung durchgeführt werden. Details finden Sie im ICU-Benutzerhandbuch. Ein Beispiel für die Verwendung des CollationElementIterator für den Sortierreihenfolgenvergleich ist die Klasse android.icu.text.StringSearch.
Um ein CollationElementIterator-Objekt zu erstellen, rufen Benutzer die Methode getCollationElementIterator() für eine RuleBasedCollator auf, die die gewünschte Sortierreihenfolge definiert.
Beispiel: <Blockquote>
String testString = "This is a test";
RuleBasedCollator rbc = new RuleBasedCollator("&a<b");
CollationElementIterator iterator = rbc.getCollationElementIterator(testString);
int primaryOrder = iterator.IGNORABLE;
while (primaryOrder != iterator.NULLORDER) {
int order = iterator.next();
if (order != iterator.IGNORABLE &&
order != iterator.NULLORDER) {
// order is valid, not ignorable and we have not passed the end
// of the iteration, we do something
primaryOrder = CollationElementIterator.primaryOrder(order);
System.out.println("Next primary order 0x" +
Integer.toHexString(primaryOrder));
}
}
</blockquote>
Die Methode next() gibt die Sortierreihenfolge des nächsten Zeichens basierend auf der Vergleichsebene des Sortierfelds zurück. Die Methode previous() gibt die Sortierreihenfolge des vorherigen Zeichens basierend auf der Vergleichsebene des Sortierfelds zurück. Die Sortierungselement-Iterator wird nur in eine Richtung zwischen Aufrufen von reset(), setOffset() oder setText() verschoben. Das heißt, next() und previous() können nicht verwendet werden. Wenn vorherige() nach next() oder umgekehrt aufgerufen werden soll, muss reset(), setOffset() oder setText() zuerst aufgerufen werden, um den Status zurückzusetzen, die aktuelle Position entweder auf das Ende oder auf den Anfang der Zeichenfolge (reset() oder setText()) oder die angegebene Position (setOffset()) zurückzusetzen. Daher wird beim nächsten Aufruf von next() oder previous() die erste oder letzte Sortierreihenfolge oder Sortierreihenfolge an der angegebenen Position zurückgegeben. Wenn eine Richtungsänderung ohne einen dieser Aufrufe erfolgt, wird das Ergebnis nicht definiert.
Diese Klasse ist nicht unterklassig.
Java Dokumentation für android.icu.text.CollationElementIterator.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.
Felder
| Name | Beschreibung |
|---|---|
| Ignorable |
Diese Konstante wird vom Iterator in den Methoden next() und previous() zurückgegeben, wenn ein Sortierungselementergebnis ignoriert werden soll. |
| Nullorder |
Diese Konstante wird vom Iterator in den Methoden next() und previous() zurückgegeben, wenn das Ende oder der Anfang der Quellzeichenfolge erreicht wurde, und es gibt keine gültigen Sortierelemente, die zurückgegeben werden sollen. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Class |
Gibt die Laufzeitklasse dieses Werts |
| Handle |
Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object) |
| JniIdentityHashCode |
Ruft den Identitätshashcode ab, der diesem Java Peer von der Interop-Laufzeit zugewiesen ist. (Geerbt von Object) |
| JniManagedPeerState |
|
| JniPeerMembers |
|
| Offset |
Gibt den Zeichenoffset in der Quellzeichenfolge zurück, der dem nächsten Sortierungselement entspricht. -or- Legt den Iterator so fest, dass er auf das Sortierungselement zeigt, das dem Zeichen am angegebenen Offset entspricht. |
| PeerReference |
Ruft den JNI-Objektverweis für diesen Java Peer ab. (Geerbt von Object) |
| ThresholdClass |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Object) |
| ThresholdType |
Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Object) |
Methoden
| Name | Beschreibung |
|---|---|
| Clone() |
Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
|
| Dispose() |
Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object) |
| Dispose(Boolean) |
Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object) |
| DisposeUnlessReferenced() |
|
| Equals(Object) |
|
| Equals(Object) |
Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object) |
| GetMaxExpansion(Int32) |
Gibt die maximale Länge einer Erweiterungssequenz zurück, die mit dem angegebenen Sortierungselement endet. |
| JavaFinalize() |
Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object) |
| Next() |
Rufen Sie das nächste Sortierungselement in der Quellzeichenfolge ab. |
| Notify() |
Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object) |
| NotifyAll() |
Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object) |
| Previous() |
Rufen Sie das vorherige Sortierungselement in der Quellzeichenfolge ab. |
| PrimaryOrder(Int32) |
Gibt die primäre Reihenfolge des angegebenen Sortierungselements zurück, i. |
| Reset() |
Setzt den Cursor auf den Anfang der Zeichenfolge zurück. |
| SecondaryOrder(Int32) |
Gibt die sekundäre Reihenfolge des angegebenen Sortierungselements zurück, i. |
| SetHandle(IntPtr, JniHandleOwnership) |
Legt die Handle-Eigenschaft fest. (Geerbt von Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
|
| SetText(ICharacterIterator) |
Legen Sie einen neuen Quellzeichenfolgen-Iterator für die Iteration fest, und setzen Sie den Offset auf den Anfang des Texts zurück. |
| SetText(String) |
Legen Sie eine neue Quellzeichenfolge für die Iteration fest, und setzen Sie den Offset auf den Anfang des Texts zurück. |
| SetText(UCharacterIterator) |
Legen Sie einen neuen Quellzeichenfolgen-Iterator für die Iteration fest, und setzen Sie den Offset auf den Anfang des Texts zurück. |
| TertiaryOrder(Int32) |
Gibt die tertiäre Reihenfolge des angegebenen Sortierungselements zurück, i. |
| ToArray<T>() |
Erstellt ein verwaltetes Array aus diesem Java Arraywrapper. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object) |
| UnregisterFromRuntime() |
Hebt die Registrierung dieses Java Peers aus der Interop-Laufzeit auf. (Geerbt von Object) |
| Wait() |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em< oder >em<unterbrochen>/em<.><> (Geerbt von Object) |
| Wait(Int64, Int32) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
| Wait(Int64) |
Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IJavaPeerable.Disposed() |
|
| IJavaPeerable.Finalized() |
|
| IJavaPeerable.JniObjectReferenceControlBlock |
|
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
|
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
|
| IJavaPeerable.SetPeerReference(JniObjectReference) |
|
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Ruft den JNI-Namen des Typs der Instanz |
| JavaAs<TResult>(IJavaPeerable) |
Versuchen Sie, die Eingabe |
| JavaCast<TResult>(IJavaObject) |
Führt eine android-laufzeitgecheckte Typkonvertierung aus. |
| JavaCast<TResult>(IJavaObject) |
|
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Versuchen Sie, die Eingabe |