CollationElementIterator 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
這個 CollationElementIterator 類別用作迭代器，用來逐步走過國際字串的每個字元。
[Android.Runtime.Register("java/text/CollationElementIterator", DoNotGenerateAcw=true)]
public sealed class CollationElementIterator : Java.Lang.Object[<Android.Runtime.Register("java/text/CollationElementIterator", DoNotGenerateAcw=true)>]
type CollationElementIterator = class
inherit Object- 繼承
- 屬性
備註
這個 CollationElementIterator 類別用作迭代器，用來逐步走過國際字串的每個字元。 使用迭代器回傳定位字元的排序優先順序。 字元的排序優先權，我們稱之為鍵，定義了字元在給定的整合物件中如何被整理。
例如，請考慮以下西班牙語 <：blockquote>
"ca" → the first key is key('c') and second key is key('a').
"cha" → the first key is key('ch') and second key is key('a').
</blockquote> 德文中，blockquote <>
"\u00e4b" → the first key is key('a'), the second key is key('e'), and
the third key is key('b').
</blockquote> 字元鍵為由主階（短序）、次序（位元組）及第三階（位元組）組成的整數。 Java 嚴格定義其原始資料型態的大小與有符號性。 因此，靜態函數 primaryOrder、 secondaryOrder、 tertiaryOrder 分別回傳 int、 short、 ， short 以確保鍵值的正確性。
遞代器使用範例，blockquote <>
String testString = "This is a test";
Collator col = Collator.getInstance();
if (col instanceof RuleBasedCollator) {
RuleBasedCollator ruleBasedCollator = (RuleBasedCollator)col;
CollationElementIterator collationElementIterator = ruleBasedCollator.getCollationElementIterator(testString);
int primaryOrder = CollationElementIterator.primaryOrder(collationElementIterator.next());
:
}
</區塊引用>
CollationElementIterator.next 回傳下一個字元的排序順序。 排序順序包含初級目、次級目和三級次序。 排序排序的資料型態為 <強>int</strong>。 排序順序的前 16 位元是其主要順序;接下來的8位元是次級階，最後8位元是三階。
<b 註：>/b<> 是實作的一部分CollationElementIterator。RuleBasedCollator 它只能用在實 RuleBasedCollator 例中。
在 1.1 版本中加入。
的 java.text.CollationElementIteratorJava 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
欄位
| 名稱 | Description |
|---|---|
| Nullorder |
無序，表示游標已到達字串的末端。 |
屬性
| 名稱 | Description |
|---|---|
| Class |
回傳此 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
這個 |
| JniPeerMembers |
這個 |
| Offset |
回傳原始文本中對應下一個排序元素的字元偏移量。 -或- 設定迭代器指向對應指定字元的排序元素（參數是原始字串中的 CHARACTER 偏移量，而非對應排序元素序列的偏移量）。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object) |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object) |
方法
| 名稱 | Description |
|---|---|
| Clone() |
建立並回傳此物件的副本。 (繼承來源 Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
這個 |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
這個 |
| Equals(Object) |
這個 |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| GetMaxExpansion(Int32) |
回傳以指定比較順序結尾的任何擴展序列的最大長度。 |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object) |
| Next() |
取得字串中的下一個整合元素。 |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| Previous() |
取得字串中之前的整合元素。 |
| PrimaryOrder(Int32) |
回傳彙整元素的主要元件。 |
| Reset() |
將游標重設到字串的開頭。 |
| SecondaryOrder(Int32) |
回傳排序元素的次要元件。 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
這個 |
| SetText(ICharacterIterator) |
設定一個新的字串來迭代。 |
| SetText(String) |
設定一個新的字串來迭代。 |
| TertiaryOrder(Int32) |
回傳排序元素的第三成分。 |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
回傳物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| Wait() |
導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object) |
| Wait(Int64, Int32) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
| Wait(Int64) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
這個 |
| IJavaPeerable.Finalized() |
這個 |
| IJavaPeerable.JniObjectReferenceControlBlock |
這個 |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
這個 |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
這個 |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
這個 |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
這個 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |