CollationElementIterator クラス

定義

名前空間:: Android.Icu.Text

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

CollationElementIterator は、文字列をウォークスルーするために RuleBasedCollator によって作成された反復子です。

[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

継承: Object

Object
CollationElementIterator

属性: RegisterAttribute

注釈

CollationElementIterator は、文字列をウォークスルーするために RuleBasedCollator によって作成された反復子です。各反復処理の戻り結果は、ソース文字列内の次の文字または文字シーケンスの順序の優先順位を定義する 32 ビット照合順序要素 (CE) です。

たとえば、スロバキア語と従来のスペイン語の照合順序では、次の点を考慮してください。 <blockquote>

"ca" -&gt; the first collation element is CE('c') and the second
                    collation element is CE('a').
            "cha" -&gt; the first collation element is CE('ch') and the second
                     collation element is CE('a').

</blockquote> ドイツ語の電話帳の照合順序では、 <blockquote>

Since the character '&#230;' is a composed character of 'a' and 'e', the
            iterator returns two collation elements for the single character '&#230;'

            "&#230;b" -&gt; 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>

照合順序の順序付けの比較では、基本的な算術演算子 (例: <、== または >) を使用するだけで照合順序要素の結果を比較することはできません。さらに処理を行う必要があります。詳細については、ICU ユーザーガイドを参照してください。照合順序の順序付けの比較に CollationElementIterator を使用する例として、クラス android.icu.text.StringSearchがあります。

CollationElementIterator オブジェクトを構築するために、ユーザーは目的の並べ替え順序を定義する RuleBasedCollator で getCollationElementIterator() メソッドを呼び出します。

例: <blockquote>

String testString = "This is a test";
             RuleBasedCollator rbc = new RuleBasedCollator("&amp;a&lt;b");
             CollationElementIterator iterator = rbc.getCollationElementIterator(testString);
             int primaryOrder = iterator.IGNORABLE;
             while (primaryOrder != iterator.NULLORDER) {
                 int order = iterator.next();
                 if (order != iterator.IGNORABLE &amp;&amp;
                     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>

メソッド next() は、コレーターの比較レベルに基づいて、次の文字の照合順序を返します。メソッド previous() は、コレーターの比較レベルに基づいて、前の文字の照合順序を返します。照合順序要素反復子は、reset()、setOffset()、または setText() の呼び出しの間でのみ一方向に移動します。つまり、next() と previous() は相互に使用できません。 next() の後に previous() を呼び出す場合、またはその逆の場合は常に、reset()、setOffset() または setText() を最初に呼び出して状態をリセットし、現在の位置を文字列の末尾または先頭 (reset() または setText()))、または指定された位置 (setOffset()) にシフトする必要があります。したがって、next() または previous() の次の呼び出し時に、指定した位置の最初または最後の照合順序、または照合順序の順序が返されます。これらの呼び出しの 1 つなしで方向の変更が行われた場合、結果は未定義になります。

このクラスはサブクラス化できません。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

フィールド

名前	説明
Ignorable	照合順序要素の結果を無視する場合、この定数はメソッド next() および previous() の反復子によって返されます。
Nullorder	この定数は、ソース文字列の末尾または先頭に達し、返す有効な照合順序要素がない場合に、next() メソッドと previous() メソッドの反復子によって返されます。

プロパティ

名前	説明
Class	この `Object`のランタイムクラスを返します。 (継承元 Object)
Handle	基になる Android インスタンスへのハンドル。 (継承元 Object)
JniIdentityHashCode	相互運用ランタイムによってこのJava ピアに割り当てられた ID ハッシュコードを取得します。 (継承元 Object)
JniPeerMembers	`CollationElementIterator` は、文字列をウォークスルーするために RuleBasedCollator によって作成された反復子です。
Offset	次の照合順序要素に対応するソース文字列の文字オフセットを返します。または、指定したオフセットの文字に対応する照合順序要素を指す反復子を設定します。
PeerReference	このJava ピアの JNI オブジェクト参照を取得します。 (継承元 Object)
ThresholdClass	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 (継承元 Object)
ThresholdType	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 (継承元 Object)

メソッド

名前	説明
Clone()	このオブジェクトのコピーを作成して返します。 (継承元 Object)
Dispose()	このJava ピアによって保持されているリソースを解放します。 (継承元 Object)
Dispose(Boolean)	このJava ピアによって保持されているリソースを解放します。 (継承元 Object)
Equals(Object)	他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object)
GetHashCode()	オブジェクトのハッシュコード値を返します。 (継承元 Object)
GetMaxExpansion(Int32)	指定した照合順序要素で終わる拡張シーケンスの最大長を返します。
JavaFinalize()	オブジェクトへの参照がなくなったとガベージコレクションによって判断されたときに、オブジェクトのガベージコレクターによって呼び出されます。 (継承元 Object)
Next()	ソース文字列内の次の照合順序要素を取得します。
Notify()	このオブジェクトのモニターで待機している 1 つのスレッドを起動します。 (継承元 Object)
NotifyAll()	このオブジェクトのモニターで待機しているすべてのスレッドを起動します。 (継承元 Object)
Previous()	ソース文字列の前の照合順序要素を取得します。
PrimaryOrder(Int32)	指定した照合順序要素 i の主な順序を返します。
Reset()	カーソルを文字列の先頭にリセットします。
SecondaryOrder(Int32)	指定した照合順序要素 i の 2 次順序を返します。
SetHandle(IntPtr, JniHandleOwnership)	Handle プロパティを設定します。 (継承元 Object)
SetText(ICharacterIterator)	反復処理用の新しいソース文字列反復子を設定し、オフセットをテキストの先頭にリセットします。
SetText(String)	イテレーション用の新しいソース文字列を設定し、オフセットをテキストの先頭にリセットします。
SetText(UCharacterIterator)	反復処理用の新しいソース文字列反復子を設定し、オフセットをテキストの先頭にリセットします。
TertiaryOrder(Int32)	指定した照合順序要素 i の 3 番目の順序を返します。
ToArray<T>()	このJava配列ラッパーからマネージド配列を作成します。 (継承元 Object)
ToString()	オブジェクトの文字列形式を返します。 (継承元 Object)
UnregisterFromRuntime()	相互運用ランタイムからこのJava ピアの登録を解除します。 (継承元 Object)
Wait()	現在のスレッドが起動するまで待機します。通常は、 <em>notified</em> または <em>interrupted</em>。 (継承元 Object)
Wait(Int64, Int32)	現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object)
Wait(Int64)	現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object)

明示的なインターフェイスの実装

名前	説明
IJavaPeerable.Disposed()	このマネージドピアが破棄されたことを相互運用ランタイムに通知します。 (継承元 Object)
IJavaPeerable.DisposeUnlessReferenced()	別のマネージド参照によって保持されない限り、このJavaピアを解放します。 (継承元 Object)
IJavaPeerable.Finalized()	このマネージドピアが終了したことを相互運用ランタイムに通知します。 (継承元 Object)
IJavaPeerable.JniManagedPeerState	このマネージドピアとその JNI 参照の間の関係を記述する状態を取得します。 (継承元 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	このJava ピアの相互運用 ID ハッシュコードを設定します。 (継承元 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	このJava ピアのマネージドピアと JNI ピアの状態を設定します。 (継承元 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	このマネージドピアで使用される JNI オブジェクト参照を設定します。 (継承元 Object)

拡張メソッド

名前	説明
GetJniTypeName(IJavaPeerable)	インスタンス `self`の型の JNI 名を取得します。
JavaAs<TResult>(IJavaPeerable)	`self`を強制的に`TResult`入力し、強制型がJava側で有効であることを確認します。
JavaCast<TResult>(IJavaObject)	Android ランタイムチェック型変換を実行します。
JavaCast<TResult>(IJavaObject)	`CollationElementIterator` は、文字列をウォークスルーするために RuleBasedCollator によって作成された反復子です。
TryJavaCast<TResult>(IJavaPeerable, TResult)	`self`を強制的に`TResult`入力し、強制型がJava側で有効であることを確認します。

適用対象