javax.swing.text
클래스 Segment

java.lang.Object 
  javax.swing.text.Segment

모든 구현된 인터페이스:

CharSequence , Cloneable , CharacterIterator

public class Segment
extends Object 
implements Cloneable , CharacterIterator , CharSequence 

텍스트의 fragment를 나타내는 문자 배열의 세그먼트(segment)입니다. 배열에 직접 액세스 할 수 있어도, 세그먼트(segment)를 변경하지 말아 주세요. 문자를 카피하는 오버헤드가 없는, 텍스트의 fragment에 빠르게 액세스 할 수 있습니다. 사실상, 보호되어 있지 않은 캐릭터 라인입니다.

Segment 는, 텍스트를 캐릭터 라인에 카피하지 않고 국제화 (i18n) 지원의 사용을 제공하기 위해서 java.text.CharacterIterator 인터페이스를 구현합니다.

필드의 개요

char[]	array 처리 대상의 텍스트를 포함한 배열입니다.
int	count 처리 대상의 텍스트를 구성하는 배열 요소의 수입니다.
int	offset 목적의 텍스트가 시작되는 배열에의 오프셋(offset)입니다.

인터페이스 java.text. CharacterIterator 로부터 상속된 필드

DONE

생성자 의 개요

Segment ()
새로운 세그먼트(segment)를 작성합니다.

Segment (char[] array, int offset, int count)
기존의 배열을 참조하는 새로운 세그먼트(segment)를 작성합니다.

메소드의 개요

char	charAt (int index) 지정된 인덱스 위치에 있는 char 치를 돌려줍니다.
Object	clone () shallow 복사를 작성합니다.
char	current () 현재 위치 (getIndex()에 의해 반환되는 위치)에 있는 문자를 가져옵니다.
char	first () 위치를 getBeginIndex()로 설정해, 그 위치에 있는 문자를 돌려줍니다.
int	getBeginIndex () 텍스트의 개시 인덱스를 돌려줍니다.
int	getEndIndex () 텍스트의 종료 인덱스를 돌려줍니다.
int	getIndex () 현재의 인덱스를 돌려줍니다.
boolean	isPartialReturn () 부분적 반환값이 유효한 것을 나타내는 플래그입니다.
char	last () 위치를 getEndIndex()-1 (텍스트가 빈 상태(empty)의 경우는 getEndIndex())로 설정해, 그 위치에 있는 문자를 돌려줍니다.
int	length () 이 문자 순서의 길이를 돌려줍니다.
char	next () 반복자의 인덱스를 1 늘려, 새로운 인덱스에 있는 문자를 돌려줍니다.
char	previous () 반복자의 인덱스를 1 줄여, 새로운 인덱스에 있는 문자를 돌려줍니다.
char	setIndex (int position) 위치가 지정된 텍스트의 위치로 설정해, 그 문자를 돌려줍니다.
void	setPartialReturn (boolean p) 부분적 반환값이 유효한 것을 나타내는 플래그입니다.
CharSequence	subSequence (int start, int end) 이 순서의 서브 순서인 신규 CharSequence 를 돌려줍니다.
String	toString () 세그먼트(segment)를 캐릭터 라인으로 변환합니다.

클래스 java.lang. Object 로부터 상속된 메소드

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

필드의 상세

array

public char[] array

처리 대상의 텍스트를 포함한 배열입니다. 이 배열은 변경하지 말아 주세요. 효율을 향상시키기 (위해)때문에인 만큼 사용됩니다.

offset

public int offset

목적의 텍스트가 시작되는 배열에의 오프셋(offset)입니다.

count

public int count

처리 대상의 텍스트를 구성하는 배열 요소의 수입니다.

생성자 의 상세

Segment

public Segment()

새로운 세그먼트(segment)를 작성합니다.

Segment

public Segment(char[] array,
               int offset,
               int count)

기존의 배열을 참조하는 새로운 세그먼트(segment)를 작성합니다.

파라미터:

array - 참조하는 배열

offset - 배열에의 오프셋(offset)

count - 문자수

메소드의 상세

setPartialReturn

public void setPartialReturn(boolean p)

부분적 반환값이 유효한 것을 나타내는 플래그입니다. 플래그가 true 의 경우, 인터페이스 메소드 Document.getText(position, length, Segment)의 구현에서는, 카피를 만들지 않고 가능한 한 많은 텍스트가 돌려주어집니다. 플래그의 디폴트 상태는 false 로, Document.getText(position, length, Segment)에 항상 같은 돌아와 동작을 실시하게 합니다. 이것은 요구에 의해 텍스트를 복제하는 경우로 하지 않는 경우가 있습니다.

파라미터:

p - 부분적 반환값이 유효한가 어떤가

도입된 버젼:

1.4

isPartialReturn

public boolean isPartialReturn()

부분적 반환값이 유효한 것을 나타내는 플래그입니다.

반환값:

부분적 반환값이 유효한가 어떤가

도입된 버젼:

1.4

toString

public String  toString()

세그먼트(segment)를 캐릭터 라인으로 변환합니다.

정의:

인터페이스 CharSequence 내의 toString

오버라이드(override):

클래스 Object 내의 toString

반환값:

캐릭터 라인

first

public char first()

위치를 getBeginIndex()로 설정해, 그 위치에 있는 문자를 돌려줍니다.

정의:

인터페이스 CharacterIterator 내의 first

반환값:

텍스트내의 선두 문자. 텍스트가 빈 상태(empty)의 경우는 DONE

도입된 버젼:

1.3

관련 항목:

getBeginIndex()

last

public char last()

위치를 getEndIndex()-1 (텍스트가 빈 상태(empty)의 경우는 getEndIndex())로 설정해, 그 위치에 있는 문자를 돌려줍니다.

정의:

인터페이스 CharacterIterator 내의 last

반환값:

텍스트내의 마지막 문자. 텍스트가 빈 상태(empty)의 경우는 DONE

도입된 버젼:

1.3

관련 항목:

getEndIndex()

current

public char current()

현재 위치 (getIndex()에 의해 반환되는 위치)에 있는 문자를 가져옵니다.

정의:

인터페이스 CharacterIterator 내의 current

반환값:

현재 위치에 있는 문자. 현재 위치가 텍스트의 마지막을 지나고 있는 경우는 DONE

도입된 버젼:

1.3

관련 항목:

getIndex()

next

public char next()

반복자의 인덱스를 1 늘려, 새로운 인덱스에 있는 문자를 돌려줍니다. 결과적으로 얻을 수 있는 인덱스가 getEndIndex()보다 큰지, 거기에 동일한 경우, 현재의 인덱스가 getEndIndex()에 리셋 되어 값 DONE 가 돌려주어집니다.

정의:

인터페이스 CharacterIterator 내의 next

반환값:

새로운 위치에 있는 문자. 새로운 위치가 텍스트의 마지막을 지나고 있는 경우는 DONE

도입된 버젼:

1.3

previous

public char previous()

반복자의 인덱스를 1 줄여, 새로운 인덱스에 있는 문자를 돌려줍니다. 현재의 인덱스가 getBeginIndex()의 경우, 인덱스는 getBeginIndex()인 채 변함없이, 값 DONE 가 돌려주어집니다.

정의:

인터페이스 CharacterIterator 내의 previous

반환값:

새로운 위치에 있는 문자. 현재의 위치가 getBeginIndex()와 동일한 경우는 DONE

도입된 버젼:

1.3

setIndex

public char setIndex(int position)

위치가 지정된 텍스트의 위치로 설정해, 그 문자를 돌려줍니다.

정의:

인터페이스 CharacterIterator 내의 setIndex

파라미터:

position - 테스트내의 위치. 유효한 값의 범위는 getBeginIndex()로부터 getEndIndex(). 이 요건을 채우지 않는 경우는 IllegalArgumentException 가 throw 된다

반환값:

지정된 위치에 있는 문자. 지정된 위치가 getEndIndex()에 동일한 경우는 DONE

도입된 버젼:

1.3

getBeginIndex

public int getBeginIndex()

텍스트의 개시 인덱스를 돌려줍니다.

정의:

인터페이스 CharacterIterator 내의 getBeginIndex

반환값:

텍스트가 시작되는 위치의 인덱스

도입된 버젼:

1.3

getEndIndex

public int getEndIndex()

텍스트의 종료 인덱스를 돌려줍니다. 이 인덱스는, 텍스트의 마지막의 다음의 문자의 인덱스입니다.

정의:

인터페이스 CharacterIterator 내의 getEndIndex

반환값:

텍스트내의 마지막 문자의 다음의 인덱스

도입된 버젼:

1.3

getIndex

public int getIndex()

현재의 인덱스를 돌려줍니다.

정의:

인터페이스 CharacterIterator 내의 getIndex

반환값:

현재의 인덱스

도입된 버젼:

1.3

charAt

public char charAt(int index)

지정된 인덱스 위치에 있는 char 치를 돌려줍니다. 인덱스는, 0 으로부터 length() - 1 의 범위가 됩니다. 배열의 인덱스부의 경우와 같이, 순서의 최초의 char 의 인덱스는 0, 다음의 문자의 인덱스는 1 으로 계속됩니다.

인덱스로 지정된 char 치가surrogate의 경우, surrogate치가 돌려주어집니다.

정의:

인터페이스 CharSequence 내의 charAt

파라미터:

index - 반환되는 char 치의 인덱스

반환값:

지정된 char 치

도입된 버젼:

1.6

length

public int length()

이 문자 순서의 길이를 돌려줍니다. 길이는 순서내의 16 비트 char 의 수에 동일해집니다.

정의:

인터페이스 CharSequence 내의 length

반환값:

이 순서의 char 의 수

도입된 버젼:

1.6

subSequence

public CharSequence  subSequence(int start,
                                int end)

이 순서의 서브 순서인 신규 CharSequence 를 돌려줍니다. 서브 순서는, 지정된 인덱스의 char 치로 시작되어, 인덱스 end - 1 의 char 치로 끝납니다. 반환되는 (char 의) 순서의 길이는 end - start 입니다. 이 때문에,start == end 의 경우, 빈 상태(empty)의 순서가 돌려주어집니다.

정의:

인터페이스 CharSequence 내의 subSequence

파라미터:

start - 개시 인덱스 (이 값을 포함한다)

end - 종료 인덱스 (이 값을 포함하지 않는다)

반환값:

지정된 서브 순서

도입된 버젼:

1.6

clone

public Object  clone()

shallow 복사를 작성합니다.

정의:

인터페이스 CharacterIterator 내의 clone

오버라이드(override):

클래스 Object 내의 clone

반환값:

카피

관련 항목:

Cloneable