java.text
클래스 BreakIterator

java.lang.Object 
  |
  +--java.text.BreakIterator

모든 구현 인터페이스:

Cloneable

public abstract class BreakIterator

extends Object

implements Cloneable

BreakIterator 클래스는 텍스트내의 경계의 위치를 찾아내는 메소드를 구현합니다. BreakIterator 의 인스턴스는 현재의 위치를 유지해, 텍스트를 스캔 해 경계가 발생하는 캐릭터의 인덱스를 돌려줍니다. 내부적으로는 BreakIterator 는 CharacterIterator 를 사용해 텍스트를 스캔 하기 위한(해), 이 프로토콜을 구현하는 임의의 오브젝트에 의해 보관 유지되는 텍스트를 스캔 할 수 있습니다. StringCharacterIterator 는 setText 에게 건네진 String 오브젝트의 스캔에 사용됩니다.

이 클래스에 의해 제공되는 팩토리 메소드를 사용해, 다양한 타입의 분할 반복자의 인스턴스를 생성합니다. 특히, 단어, 행, 문, 및 캐릭터의 경계 해석을 실행하는 BreakIterator 를 생성하려면 , 각각 getWordIterator,getLineIterator,getSentenceIterator, 및 getCharacterIterator 를 사용합니다. 단일의 BreakIterator 는 1 개의 유니트 (단어, 행, 문장등)만을 처리하기 위해(때문에), 실행하는 유니트 경계 해석 마다 다른 반복자를 사용할 필요가 있습니다.

행의 경계 해석에서는 텍스트 캐릭터 라인을 행 즉시 로 분할하는 위치를 판정합니다. 구두점 및 하이픈 자동 삽입 된 단어도, 기구에 의해 올바르게 처리됩니다.

문장의 경계 해석에서는 숫자와 약어안의 피리어드, 인용부호나 괄호 등에 계속되는 구두점의 올바른 해석에 대해 선택이 가능합니다.

단어의 경계 해석은 검색 치환 기능으로 사용됩니다. 또, 텍스트 편집 어플리케이션내에서, 더블 클릭에 의해 단어가 선택 가능하게 됩니다. 단어 선택에서는 구두점과 함께, 기호나 구두점등과 같이 단어가 일부에서 없는 캐릭터, 전후에 분할이 있는 캐릭터도 올바르게 해석됩니다.

캐릭터의 경계 해석에서는 예를 들어 커서를 텍스트 캐릭터 라인에 따라 움직이는 것 같은 경우에, 유저가 예측하는 대로의 조작을 하도록(듯이) 합니다. 캐릭터의 경계 해석에 의해, 캐릭터의 저장 방법으로 의존하지 않고 캐릭터 라인의 올바른 네비게이션이 가능하게 됩니다. 예를 들어, 엑센트 첨부의 캐릭터는 기준 캐릭터와 발음 구별 부호로서 저장되고 있는 경우가 있습니다. 유저의 캐릭터에 대한 인식은 언어간에 다릅니다.

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.charAt(p))
                 return last;
         }
         last = current;
         current = wb.next();
     }
     return BreakIterator.DONE;
 }
 

(BreakIterator.getWordInstance()에 의해 돌려주어지는 반복자는 일의이기 (위해)때문에, 돌려주어지는 분할 위치는 반복의 시작과 종료의 양쪽 모두를 나타내는 것이 아닙니다. 즉, 문장을 분할하는 반복자는 각각이 1 개의 문장의 종료와 다음의 문장의 개시를 나타내는 분할을 돌려줍니다. 단어를 분할하는 반복자에서는 2 개의 경계간의 캐릭터가 단어, 구두점, 또는 2 개의 단어간의 공백 캐릭터의 경우가 있습니다. 상기의 코드에서는 단순한 발견적 방법을 사용해, 단어의 개시의 경계를 판정하고 있습니다. 어느 경계와 다음의 경계의 사이의 캐릭터가, 적어도 1 개의 캐릭터 (알파벳, CJK 통합 한자, 한글 캐릭터, 가명등)를 포함한 경우는 이 경계와 다음의 경계의 사이의 텍스트를 단어로 해, 그렇지 않은 경우는 단어간의 데이터라고 봅니다. )

관련 항목:

CharacterIterator

필드의 개요

static int

DONE 모든 유효한 경계가 돌려주어지고 나서, previous()와 next()에 의해 DONE 가 돌려주어집니다.

생성자의 개요

protected

BreakIterator () constructor 입니다.

메소드의 개요

Object	clone () 반복자의 카피를 작성합니다.
abstract int	current () next(), previous(), first(), 또는 last()에 의해 마지막에 돌려주어진 텍스트 경계의 캐릭터 인덱스를 돌려줍니다.
abstract int	first () 최초의 경계를 돌려줍니다.
abstract int	following (int offset) 지정된 오프셋(offset)에 계속되는 최초의 경계를 돌려줍니다.
static Locale []	getAvailableLocales () BreakIterators 가 도입되고 있는 로케일 세트를 취득합니다.
static BreakIterator	getCharacterInstance () 디폴트의 로케일을 사용해, 캐릭터 분할을 위한 BreakIterator 을 생성합니다.
static BreakIterator	getCharacterInstance (Locale where) 지정된 로케일을 사용해, 캐릭터 분할을 위한 BreakIterator 를 생성합니다.
static BreakIterator	getLineInstance () 디폴트의 로케일을 사용해, 행 분할을 위한 BreakIterator 를 생성합니다.
static BreakIterator	getLineInstance (Locale where) 지정한 로케일을 사용해, 행 분할을 위한 BreakIterator 를 생성합니다.
static BreakIterator	getSentenceInstance () 디폴트의 로케일을 사용해 문장 분할을 위한 BreakIterator 를 생성합니다.
static BreakIterator	getSentenceInstance (Locale where) 지정된 로케일을 사용해, 문장 분할을 위한 BreakIterator 를 생성합니다.
abstract CharacterIterator	getText () 스캔 되는 텍스트를 취득합니다.
static BreakIterator	getWordInstance () 디폴트의 로케일을 사용해, 단어 분할을 위한 BreakIterator 를 생성합니다.
static BreakIterator	getWordInstance (Locale where) 지정한 로케일을 사용해, 단어 분할을 위한 BreakIterator 를 생성합니다.
boolean	isBoundary (int offset) 지정된 위치가 경계 위치의 경우에 true 를 돌려줍니다.
abstract int	last () 마지막 경계를 돌려줍니다.
abstract int	next () 현재의 경계에 계속되는 경계를 돌려줍니다.
abstract int	next (int n) 현재의 경계로부터 n 번째의 경계를 돌려줍니다.
int	preceding (int offset) 지정된 오프셋(offset)보다 전방에 있는 마지막 경계를 돌려줍니다.
abstract int	previous () 현재의 경계에 선행하는 경계를 돌려줍니다.
abstract void	setText (CharacterIterator newText) 스캔 되는 새로운 텍스트를 설정합니다.
void	setText (String newText) 스캔 되는 새로운 텍스트 캐릭터 라인을 설정합니다.

클래스 java.lang. Object 에서 상속받은 메소드

equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

필드의 상세

DONE

public static final int DONE

모든 유효한 경계가 돌려주어지고 나서, previous()와 next()에 의해 DONE 가 돌려주어집니다.

관련 항목:

정수 필드치

생성자의 상세

BreakIterator

protected BreakIterator()

constructor 입니다. BreakIterator 에는 상태가 없고, 디폴트의 동작이 없습니다.

메소드의 상세

clone

public Object  clone()

반복자의 카피를 작성합니다.

오버라이드(override):

클래스 Object 내의 clone

반환값:

이 반복자의 카피

관련 항목:

Cloneable

first

public abstract int first()

최초의 경계를 돌려줍니다. 반복자의 현재 위치는 최초의 경계로 설정됩니다.

반환값:

최초의 텍스트 경계의 캐릭터 인덱스

last

public abstract int last()

마지막 경계를 돌려줍니다. 반복자의 현재 위치는 마지막 경계로 설정됩니다.

반환값:

마지막 텍스트 경계의 캐릭터 인덱스

next

public abstract int next(int n)

현재의 경계로부터 n 번째의 경계를 돌려줍니다.

파라미터:

n - 돌려주어지는 경계. 값이 0 의 경우, 아무것도 하지 않는다. 부의 값은 전방의 경계에 이동해, 정의 값은 후방의 경계에 이동한다

반환값:

현재 위치로부터 n 번째의 경계의 인덱스

next

public abstract int next()

현재의 경계에 계속되는 경계를 돌려줍니다.

반환값:

모든 경계가 돌려주어지고 있는 경우는 다음의 텍스트 경계의 캐릭터 인덱스 또는 DONE. next(1)에 동일하다

previous

public abstract int previous()

현재의 경계에 선행하는 경계를 돌려줍니다.

반환값:

전의 텍스트 경계의 캐릭터 인덱스, 또는 모든 경계가 돌려주어지고 있는 경우는 DONE

following

public abstract int following(int offset)

지정된 오프셋(offset)에 계속되는 최초의 경계를 돌려줍니다. 돌려주어지는 값은 항상 오프셋(offset)보다 큰지 또는 값 BreakIterator.DONE 입니다.

파라미터:

offset - 스캔 개시에의 오프셋(offset). 이 값은 setText()에게 건네지는 CharacterIterator 에 의해 판정되지 않으면 안 된다. 무효인 값을 지정하면(자), IllegalArgumentException 가 슬로우 된다

반환값:

지정된 오프셋(offset)의 뒤의 최초의 경계

preceding

public int preceding(int offset)

지정된 오프셋(offset)보다 전방에 있는 마지막 경계를 돌려줍니다. 돌려주어지는 값은 항상, 오프셋(offset)보다 작은가 값 BreakIterator.DONE 입니다.

파라미터:

offset - 스캔 개시에의 오프셋(offset). 이 값은 setText()에게 건네진 CharacterIterator 에 의해 판정되지 않으면 안 된다. 무효인 값을 지정하면(자), IllegalArgumentException 가 슬로우 된다

반환값:

지정된 오프셋(offset)의 전의 마지막 경계

isBoundary

public boolean isBoundary(int offset)

지정된 위치가 경계 위치의 경우에 true 를 돌려줍니다.

파라미터:

offset - 체크 대상의 오프셋(offset)

반환값:

오프셋(offset)가 경계 위치의 경우는 true

current

public abstract int current()

next(), previous(), first(), 또는 last()에 의해 마지막에 돌려주어진 텍스트 경계의 캐릭터 인덱스를 돌려줍니다.

반환값:

마지막에 돌려주어진 경계

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()

디폴트의 로케일을 사용해, 단어 분할을 위한 BreakIterator 를 생성합니다. 단어 분할을 구현하는 BreakIterator 의 인스턴스를 돌려줍니다. WordBreak 는 더블 클릭등의 단어 선택에 유용합니다.

반환값:

단어 분할을 위한 BreakIterator

관련 항목:

Locale.getDefault()

getWordInstance

public static BreakIterator  getWordInstance(Locale  where)

지정한 로케일을 사용해, 단어 분할을 위한 BreakIterator 를 생성합니다. 단어 분할을 구현하는 BreakIterator 의 인스턴스를 돌려줍니다. WordBreak 는 더블 클릭등의 단어 선택에 유용합니다.

파라미터:

where - 로케일. 지정한 로케일에 대해서 특정의 WordBreak 가 사용 불가의 경우는 디폴트의 WordBreak 가 돌려주어진다

반환값:

단어 분할을 위한 BreakIterator

getLineInstance

public static BreakIterator  getLineInstance()

디폴트의 로케일을 사용해, 행 분할을 위한 BreakIterator 를 생성합니다. 행 분할을 구현하는 BreakIterator 의 인스턴스를 돌려줍니다. LineBreak 는 논리적으로 가능한 행 분할이며, 실제의 행 분할은 통상, 표시폭에 의해 정해집니다. LineBreak 는 단어 즉시 텍스트에 유용합니다.

반환값:

행 분할을 위한 BreakIterator

관련 항목:

Locale.getDefault()

getLineInstance

public static BreakIterator  getLineInstance(Locale  where)

지정한 로케일을 사용해, 행 분할을 위한 BreakIterator 를 생성합니다. 행 분할을 구현하는 BreakIterator 의 인스턴스를 돌려줍니다. LineBreak 는 논리적으로 가능한 행 분할이며, 실제의 행 분할은 통상, 표시폭에 의해 정해집니다. LineBreak 는 단어 즉시 텍스트에 유용합니다.

파라미터:

where - 로케일. 지정한 로케일에 대해서 특정의 LineBreak 가 사용 불가의 경우는 디폴트의 LineBreak 가 돌려주어진다

반환값:

행 분할을 위한 BreakIterator

getCharacterInstance

public static BreakIterator  getCharacterInstance()

디폴트의 로케일을 사용해, 캐릭터 분할을 위한 BreakIterator 를 생성합니다. 캐릭터 분할을 구현하는 BreakIterator 의 인스턴스를 돌려줍니다. 캐릭터 분할은 결합 캐릭터 순차 순서의 경계입니다.

반환값:

캐릭터 분할을 위한 BreakIterator

관련 항목:

Locale.getDefault()

getCharacterInstance

public static BreakIterator  getCharacterInstance(Locale  where)

지정된 로케일을 사용해, 캐릭터 분할을 위한 BreakIterator 를 생성합니다. 캐릭터 분할을 구현하는 BreakIterator 의 인스턴스를 돌려줍니다. 캐릭터 분할은 결합 캐릭터 순차 순서의 경계입니다.

파라미터:

where - 로케일. 지정한 로케일에 대해서 특정의 캐릭터 분할이 사용 불가의 경우는 디폴트의 캐릭터 분할이 돌려주어진다

반환값:

캐릭터 분할을 위한 BreakIterator

getSentenceInstance

public static BreakIterator  getSentenceInstance()

디폴트의 로케일을 사용해 문장 분할을 위한 BreakIterator 를 생성합니다. 문장 분할을 구현하는 BreakIterator 의 인스턴스를 돌려줍니다.

반환값:

문 분할을 위한 BreakIterator

관련 항목:

Locale.getDefault()

getSentenceInstance

public static BreakIterator  getSentenceInstance(Locale  where)

지정된 로케일을 사용해, 문장 분할을 위한 BreakIterator 를 생성합니다. 문장 분할을 구현하는 BreakIterator 의 인스턴스를 돌려줍니다.

파라미터:

where - 로케일. 지정한 로케일에 대해서 특정의 SentenceBreak 가 사용 불가의 경우는 디폴트의 SentenceBreak 가 돌려주어진다

반환값:

문 분할을 위한 BreakIterator

getAvailableLocales

public static Locale [] getAvailableLocales()

BreakIterators 가 도입되고 있는 로케일 세트를 취득합니다.

반환값:

사용 가능한 로케일