java.lang.Object
- java.text.BreakIterator

实现的所有接口

Cloneable
```
public abstract class BreakIterator
extends Object
implements Cloneable
```
BreakIterator类实现了在文本中查找边界位置的方法。 BreakIterator实例保持当前位置并扫描文本，返回出现边界的字符索引。在内部， BreakIterator扫描文本使用CharacterIterator ，并且因此能够扫描通过实现协议的任何对象保存文本。 A StringCharacterIterator用于扫描传递给setText String对象。
您可以使用此类提供的工厂方法来创建各种类型的break迭代器的实例。尤其是，使用getWordInstance ， getLineInstance ， getSentenceInstance和getCharacterInstance创造BreakIterator s表示分别执行字，行，句子和字符边界分析。单个BreakIterator只能在一个单元（单词，行，句子等）上工作。必须为要执行的每个单元边界分析使用不同的迭代器。

行边界分析确定换行时文本字符串可以断开的位置。该机制正确处理标点符号和带连字符的单词。实际断线还需要考虑可用的线宽，并由更高级别的软件处理。

句子边界分析允许选择正确解释数字和缩写中的句点，以及跟踪标点符号（如引号和括号）。

单词边界分析由搜索和替换函数以及文本编辑应用程序使用，允许用户通过双击选择单词。单词选择可以正确解释单词内和单词后面的标点符号。不属于单词的字符（如符号或标点符号）在两侧都有单词分隔符。

字符边界分析允许用户按照他们期望的方式与字符进行交互，例如，当将光标移动到文本字符串时。无论角色的存储方式如何，字符边界分析都能提供正确的字符串导航。返回的边界可以是补充字符，组合字符序列或连字簇的边界。例如，重音字符可以存储为基本字符和变音符号。用户认为角色的用语可能因语言而异。

BreakIterator的工厂方法返回的BreakIterator实例仅用于自然语言，不适用于编程语言文本。但是，可以定义用于标记编程语言的子类。

示例：

创建和使用文本边界：
```
 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);
      }
 }
 
```
按顺序打印每个元素：
```
 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));
     }
 }
 
```
以相反的顺序打印每个元素：
```
 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));
 }
 
```
在指定位置打印元素：
```
 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 last = wb.following(pos);
     int current = wb.next();
     while (current != BreakIterator.DONE) {
         for (int p = last; p < current; p++) {
             if (Character.isLetter(text.codePointAt(p)))
                 return last;
         }
         last = current;
         current = wb.next();
     }
     return BreakIterator.DONE;
 }
 
```
(The iterator returned by BreakIterator.getWordInstance() is unique in that the break positions it returns don't represent both the start and end of the thing being iterated over. That is, a sentence-break iterator returns breaks that each represent the end of one sentence and the beginning of the next. With the word-break iterator, the characters between two boundaries might be a word, or they might be the punctuation or whitespace between two words. The above code uses a simple heuristic to determine which boundary is the beginning of a word: If the characters between this boundary and the next boundary include at least one letter (this can be an alphabetical letter, a CJK ideograph, a Hangul syllable, a Kana character, etc.), then the text between this boundary and the next is a word; otherwise, it's the material between words.)
从以下版本开始：

1.1

另请参见：

CharacterIterator

字段汇总

字段
变量和类型	字段	描述
`static int`	`DONE`	当达到第一个或最后一个文本边界时，由前一个（），下一个（），下一个（整数），前一个（整数）和后一个（整数）返回DONE。

构造方法摘要

构造方法

变量构造器描述

protected BreakIterator()
构造函数。

方法摘要

所有方法静态方法实例方法抽象方法具体的方法
变量和类型	方法	描述
`Object`	`clone()`	创建此迭代器的副本
`abstract int`	`current()`	返回next（），next（int），previous（），first（），last（），following（int）或previous（int）最近返回的文本边界的字符索引。
`abstract int`	`first()`	返回第一个边界。
`abstract int`	`following(int offset)`	返回指定字符偏移量后的第一个边界。
`static Locale[]`	`getAvailableLocales()`	返回 `get*Instance`方法可以返回本地化实例的所有语言环境的数组。
`static BreakIterator`	`getCharacterInstance()`	为 default locale返回 `BreakIterator`的新实例 BreakIterator 。
`static BreakIterator`	`getCharacterInstance(Locale locale)`	返回一个新 `BreakIterator`例如 character breaks给定语言环境。
`static BreakIterator`	`getLineInstance()`	返回一个新 `BreakIterator`例如 line breaks为 default locale 。
`static BreakIterator`	`getLineInstance(Locale locale)`	为给定的语言环境返回 `BreakIterator`的新实例 BreakIterator 。
`static BreakIterator`	`getSentenceInstance()`	为 default locale返回 `BreakIterator`的新实例 BreakIterator 。
`static BreakIterator`	`getSentenceInstance(Locale locale)`	为给定的语言环境返回 `BreakIterator`的新实例 4347205155543 。
`abstract CharacterIterator`	`getText()`	获取正在扫描的文本
`static BreakIterator`	`getWordInstance()`	返回一个新 `BreakIterator`例如 word breaks为 default locale 。
`static BreakIterator`	`getWordInstance(Locale locale)`	为给定的语言环境返回 `BreakIterator`的新实例 BreakIterator 。
`boolean`	`isBoundary(int offset)`	如果指定的字符偏移量是文本边界，则返回true。
`abstract int`	`last()`	返回最后一个边界。
`abstract int`	`next()`	返回当前边界之后的边界。
`abstract int`	`next(int n)`	返回当前边界的第n个边界。
`int`	`preceding(int offset)`	返回指定字符偏移量之前的最后一个边界。
`abstract int`	`previous()`	返回当前边界之前的边界。
`void`	`setText(String newText)`	设置要扫描的新文本字符串。
`abstract void`	`setText(CharacterIterator newText)`	设置新文本进行扫描。

声明方法的类 java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细信息
  - DONE
```
public static final int DONE
```
    当达到第一个或最后一个文本边界时，由前一个（），下一个（），下一个（整数），前一个（整数）和后一个（整数）返回DONE。
    
    另请参见：
    
    常数字段值
- 构造方法详细信息
  - BreakIterator
```
protected BreakIterator()
```
    构造函数。 BreakIterator是无状态的，没有默认行为。
- 方法详细信息
  - clone
```
public Object clone()
```
    创建此迭代器的副本
    
    重写：
    
    clone在课程 Object
    
    结果
    
    这份的副本
    
    另请参见：
    
    Cloneable
  - first
```
public abstract int first()
```
    返回第一个边界。迭代器的当前位置设置为第一个文本边界。
    
    结果
    
    第一个文本边界的字符索引。
  - last
```
public abstract int last()
```
    返回最后一个边界。迭代器的当前位置设置为最后一个文本边界。
    
    结果
    
    最后一个文本边界的字符索引。
  - next
```
public abstract int next(int n)
```
    返回当前边界的第n个边界。如果已达到第一个或最后一个文本边界，则返回BreakIterator.DONE ，并将当前位置设置为第一个或最后一个文本边界，具体取决于到达哪个边界。否则，迭代器的当前位置将设置为新边界。例如，如果迭代器的当前位置是第m个文本边界，并且从当前边界到最后一个文本边界存在另外三个边界，则下一个（2）调用将返回m + 2.新文本位置设置为（m + 2）文本边界。 next（4）调用将返回BreakIterator.DONE ，最后一个文本边界将成为新的文本位置。
    
    参数
    
    n - 返回哪个边界。值0不起作用。负值移动到先前的边界，正值移动到后面的边界。
    
    结果
    
    当前位置的第n个边界的字符索引，如果已达到第一个或最后一个文本边界， BreakIterator.DONE 。
  - next
```
public abstract int next()
```
    返回当前边界之后的边界。如果当前边界是最后一个文本边界，则返回BreakIterator.DONE并且迭代器的当前位置不变。否则，迭代器的当前位置将设置为当前边界之后的边界。
    
    结果
    
    如果当前边界是最后一个文本边界， BreakIterator.DONE下一个文本边界的字符索引或BreakIterator.DONE 。相当于下一个（1）。
    
    另请参见：
    
    next(int)
  - previous
```
public abstract int previous()
```
    返回当前边界之前的边界。如果当前边界是第一个文本边界，则返回BreakIterator.DONE并且迭代器的当前位置不变。否则，迭代器的当前位置将设置为当前边界之前的边界。
    
    结果
    
    如果当前边界是第一个文本边界，则前一个文本边界的字符索引或 BreakIterator.DONE 。
  - following
```
public abstract int following(int offset)
```
    返回指定字符偏移量后的第一个边界。如果指定的偏移量等于最后一个文本边界，则返回BreakIterator.DONE并且迭代器的当前位置不变。否则，迭代器的当前位置将设置为返回的边界。返回的值始终大于偏移量或值BreakIterator.DONE 。
    
    参数
    
    offset - 开始扫描的字符偏移量。
    
    结果
    
    指定偏移量后的第一个边界或 BreakIterator.DONE如果最后一个文本边界作为偏移量传入）。
    
    异常
    
    IllegalArgumentException - 如果指定的偏移量小于第一个文本边界或大于最后一个文本边界。
  - preceding
```
public int preceding(int offset)
```
    返回指定字符偏移量之前的最后一个边界。如果指定的偏移量等于第一个文本边界，则返回BreakIterator.DONE ，并且迭代器的当前位置不变。否则，迭代器的当前位置将设置为返回的边界。返回的值始终小于偏移量或值BreakIterator.DONE 。
    
    参数
    
    offset - 开始扫描的字符偏移量。
    
    结果
    
    指定偏移量之前的最后一个边界，如果第一个文本边界作为偏移量传入， BreakIterator.DONE 。
    
    异常
    
    IllegalArgumentException - 如果指定的偏移量小于第一个文本边界或大于最后一个文本边界。
    
    从以下版本开始：
    
    1.2
  - isBoundary
```
public boolean isBoundary(int offset)
```
    如果指定的字符偏移量是文本边界，则返回true。
    
    参数
    
    offset - 要检查的字符偏移量。
    
    结果
    
    true如果“offset”是边界位置， false 。
    
    异常
    
    IllegalArgumentException - 如果指定的偏移量小于第一个文本边界或大于最后一个文本边界。
    
    从以下版本开始：
    
    1.2
  - current
```
public abstract int current()
```
    返回next（），next（int），previous（），first（），last（），following（int）或previous（int）最近返回的文本边界的字符索引。如果这些方法中的任何一个返回BreakIterator.DONE因为已达到第一个或最后一个文本边界，它将返回第一个或最后一个文本边界，具体取决于到达哪个。
    
    结果
    
    从上述方法返回的文本边界，第一个或最后一个文本边界。
    
    另请参见：
    
    next() ， next(int) ， previous() ， first() ， last() ， following(int) ， preceding(int)
  - getText
```
public abstract CharacterIterator getText()
```
    获取正在扫描的文本
    
    结果
    
    正在扫描的文本
  - setText
```
public void setText(String newText)
```
    设置要扫描的新文本字符串。当前扫描位置重置为first（）。
    
    参数
    
    newText - 要扫描的新文本。
  - setText
```
public abstract void setText(CharacterIterator newText)
```
    设置新文本进行扫描。当前扫描位置重置为first（）。
    
    参数
    
    newText - 要扫描的新文本。
  - getWordInstance
```
public static BreakIterator getWordInstance()
```
    为 default locale返回 BreakIterator的新实例 4347205395714 。
    
    结果
    
    单词中断的中断迭代器
  - getWordInstance
```
public static BreakIterator getWordInstance(Locale locale)
```
    为给定的语言环境返回 BreakIterator的新实例 BreakIterator 。
    
    参数
    
    locale - 所需的语言环境
    
    结果
    
    单词中断的中断迭代器
    
    异常
    
    NullPointerException - 如果 locale为空
  - getLineInstance
```
public static BreakIterator getLineInstance()
```
    返回一个新 BreakIterator例如 line breaks为 default locale 。
    
    结果
    
    换行符的断点迭代器
  - getLineInstance
```
public static BreakIterator getLineInstance(Locale locale)
```
    为给定的语言环境返回 BreakIterator的新实例 BreakIterator 。
    
    参数
    
    locale - 所需的区域设置
    
    结果
    
    换行符的断点迭代器
    
    异常
    
    NullPointerException - 如果 locale为空
  - getCharacterInstance
```
public static BreakIterator getCharacterInstance()
```
    返回一个新 BreakIterator例如 character breaks为 default locale 。
    
    结果
    
    用于字符中断的break迭代器
  - getCharacterInstance
```
public static BreakIterator getCharacterInstance(Locale locale)
```
    为给定的语言环境返回 BreakIterator的新实例 BreakIterator 。
    
    参数
    
    locale - 所需的区域设置
    
    结果
    
    用于字符中断的break迭代器
    
    异常
    
    NullPointerException - 如果 locale为空
  - getSentenceInstance
```
public static BreakIterator getSentenceInstance()
```
    返回一个新 BreakIterator例如 sentence breaks为 default locale 。
    
    结果
    
    句子中断的中断迭代器
  - getSentenceInstance
```
public static BreakIterator getSentenceInstance(Locale locale)
```
    返回一个新 BreakIterator例如 sentence breaks给定语言环境。
    
    参数
    
    locale - 所需的语言环境
    
    结果
    
    句子中断的中断迭代器
    
    异常
    
    NullPointerException - 如果 locale为空
  - getAvailableLocales
```
public static Locale[] getAvailableLocales()
```
    返回所有语言环境的数组， get*Instance方法可以get*Instance返回本地化实例。返回的数组表示Java运行时和已安装的BreakIteratorProvider实现支持的语言环境的并集。它必须至少包含Locale实例，等于Locale.US 。
    
    结果
    
    可为其提供本地化 BreakIterator实例的语言环境数组。

Class BreakIterator

字段汇总

构造方法摘要

方法摘要

声明方法的类 java.lang.Object

字段详细信息

DONE

构造方法详细信息

BreakIterator

方法详细信息

clone

first

last

next

next

previous

following

preceding

isBoundary

current

getText

setText

setText

getWordInstance

getWordInstance

getLineInstance

getLineInstance

getCharacterInstance

getCharacterInstance

getSentenceInstance

getSentenceInstance

getAvailableLocales