BreakIterator 類別

定義

[Android.Runtime.Register("android/icu/text/BreakIterator", ApiSince=24, DoNotGenerateAcw=true)]
public abstract class BreakIterator : Java.Lang.Object, IDisposable, Java.Lang.ICloneable

[<Android.Runtime.Register("android/icu/text/BreakIterator", ApiSince=24, DoNotGenerateAcw=true)>]
type BreakIterator = class
    inherit Object
    interface ICloneable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

繼承

Object

JavaObject

Object

BreakIterator

屬性

RegisterAttribute

實作

IJavaObject IJavaPeerable ICloneable IDisposable

備註

<強力>[加護病房增強]</強重> 加護病房取代 java.text.BreakIterator. ICU特有的方法、領域及其他功能標示為「<強力>[重症監護室]</強力>」。

一個能在文字中定位邊界的類別。 此類別定義了一套物件的協定，用於根據一組標準將自然語言文本分割。 例如，可以提供 BreakIterator 的實例或子類別，將一段文字拆解成單字、句子或邏輯字元，並依照某語言或語言群的慣例。

我們提供五種內建的 BreakIterator： <ul><li>getTitleInstance（） 回傳一個 BreakIterator，用來定位標題中斷之間的邊界。 <li>getSentenceInstance（） 回傳一個 BreakIterator，用來定位句子之間的邊界。 例如，這對於三連擊選擇非常有幫助。 <li>getWordInstance（） 回傳一個 BreakIterator，用來定位字詞間的邊界。 這對於雙擊選取或「尋找整字」搜尋非常有用。 這種類型的 BreakIterator 確保每個法律詞的開頭和結尾都有邊界位置。 （數字也算作詞彙。）空白和標點符號與真實詞彙是分開的。 <li>getLineInstance（） 會回傳一個 BreakIterator，該處會定位文字編輯器允許繞行的位置。 這類似於單字分隔，但不完全相同：標點符號和空白通常會保留在單字上（例如你不希望一行以空格開頭），而某些特殊字元可以強制某個位置被視為換行位置，或阻止該位置成為換行位置。 <li>getCharacterInstance（） 會回傳一個 BreakIterator，用來定位邏輯字元之間的邊界。 由於 Unicode 編碼的結構，一個邏輯字元可以內部儲存為多個 Unicode 碼點。 （例如，帶有變音符號的 A 可以儲存為 a 後接一個獨立的合併變音符號，但使用者仍會將其視為一個字元。）此迭代器允許各種程序（尤其是文字編輯器）將使用者視為字元的文字單位視為字元，而非電腦視為「字元」的文字單位。</ul> 文本邊界位置依據 Unicode 標準附錄 #29、文字邊界及 Unicode 標準附錄 #14 換行屬性中描述的規則來確定。 這些資料可於 http://www.unicode.org/reports/tr14/ 以下網站取得 http://www.unicode.org/reports/tr29/.

BreakIterator 的介面採用「迭代器」模型（因此得名），意即它有「當前位置」的概念，以及像 first（）、last（）、next（）、before（） 等方法來更新當前位置。 所有分斷迭代器都維持以下不變式： <ul><li>文本的開頭與結尾始終被視為邊界位置。 <li>迭代器的當前位置總是邊界位置（隨機存取方法將迭代器移動到指定位置之前或之後最近的邊界位置 ，而非 指定位置）。 <li>DONE 用作標記，表示迭代停止。 DONE 僅在當前位置為文字結尾且使用者呼叫 next（） 時回傳，或當前位置為文字開頭且使用者呼叫 prevreious（）。 <li>Break 位置由後面角色的位置編號。 因此，在正常情況下，第一個字元前的位置為 0，第一個字元後的位置為 1，最後一個字元後的位置為 1 加上字串長度。 <li>客戶端可以隨意改變迭代器的位置或其分析的文本，但無法改變行為本身。 若使用者想要不同的行為，他必須實例化一個新的迭代器。</ul>

BreakIterator 透過 CharacterIterator 存取其分析的文本，這使得任何提供 CharacterIterator 介面的文本儲存載體中都能使用 BreakIterator 來分析文本。

<b>注意：</b> 某些類型的 BreakIterator 建立可能耗時較長，且系統目前並未快取 BreakIterator 的實例。 為了達到最佳效能，建議盡可能長時間保留 BreakIterator 實例。 例如，在換行文件時，不要為每行建立或銷毀新的 BreakIterator。 為整個文件（或你要換行的文字區段）建立一個 break 迭代器，用它來完成整個文字的包裝工作。

<強而有力>的例子</強力>：

建立與使用文字邊界 <blockquote>

public static void main(String args[]) {
                 if (args.length == 1) {
                     String stringToExamine = args[0];
                     //print each word in order
                     BreakIterator boundary = BreakIterator.getWordInstance();
                     boundary.setText(stringToExamine);
                     printEachForward(boundary, stringToExamine);
                     //print each sentence in reverse order
                     boundary = BreakIterator.getSentenceInstance(Locale.US);
                     boundary.setText(stringToExamine);
                     printEachBackward(boundary, stringToExamine);
                     printFirst(boundary, stringToExamine);
                     printLast(boundary, stringToExamine);
                 }
            }

</區塊引用>

請依序 <列印每個元素 blockquote>

public static void printEachForward(BreakIterator boundary, String source) {
                int start = boundary.first();
                for (int end = boundary.next();
                     end != BreakIterator.DONE;
                     start = end, end = boundary.next()) {
                     System.out.println(source.substring(start,end));
                }
            }

</區塊引用>

將每個元素以反向順序 <列印 blockquote>

public static void printEachBackward(BreakIterator boundary, String source) {
                int end = boundary.last();
                for (int start = boundary.previous();
                     start != BreakIterator.DONE;
                     end = start, start = boundary.previous()) {
                    System.out.println(source.substring(start,end));
                }
            }

</區塊引用>

列印第一個元素 <的區塊引用>

public static void printFirst(BreakIterator boundary, String source) {
                int start = boundary.first();
                int end = boundary.next();
                System.out.println(source.substring(start,end));
            }

</區塊引用>

列印最後一個元素 <的區塊引用>

public static void printLast(BreakIterator boundary, String source) {
                int end = boundary.last();
                int start = boundary.previous();
                System.out.println(source.substring(start,end));
            }

</區塊引用>

在指定位置 <列印元素 blockquote>

public static void printAt(BreakIterator boundary, int pos, String source) {
                int end = boundary.following(pos);
                int start = boundary.previous();
                System.out.println(source.substring(start,end));
            }

</區塊引用>

尋找下一個引用單字<>

public static int nextWordStartAfter(int pos, String text) {
                BreakIterator wb = BreakIterator.getWordInstance();
                wb.setText(text);
                int wordStart = wb.following(pos);
                for (;;) {
                    int wordLimit = wb.next();
                    if (wordLimit == BreakIterator.DONE) {
                        return BreakIterator.DONE;
                    }
                    int wordStatus = wb.getRuleStatus();
                    if (wordStatus != BreakIterator.WORD_NONE) {
                        return wordStart;
                    }
                    wordStart = wordLimit;
                 }
            }

回傳的 #getWordInstance 迭代器獨特之處在於它回傳的中斷位置並不代表被迭代事物的開始和結束。 也就是說，句子斷行迭代器回傳的斷點，分別代表一個句子的結尾和下一個句子的開頭。 使用詞分隔迭代器時，兩個邊界之間的字元可能是單字，也可能是兩個字之間的標點符號或空白。 上述程式碼用 #getRuleStatus 來識別並忽略與標點符號或其他非字元相關的邊界。 </區塊引用>

Java 文件 android.icu.text.BreakIterator。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。