javax.swing.text
类 Segment

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

所有已实现的接口：

CharSequence, Cloneable, CharacterIterator

public class Segment
extends Object
implements Cloneable, CharacterIterator, CharSequence

表示文本片段的字符数组的 segment。尽管能够直接访问数组，也应将其视为不可变的。此实现提供了对文本片段的快速访问，而且不存在来回复制字符的开销。它实际上是一个未受保护的 String。

Segment 实现 java.text.CharacterIterator 接口以支持对国际化支持的使用，而不用将文本复制到某个字符串。

字段摘要

char[]	array 这是包含了所需文本的数组。
int	count 这是构成所需文本的数组元素的数目。
int	offset 这是所需文件开始处的数组偏移量。

从接口 java.text.CharacterIterator 继承的字段

DONE

构造方法摘要

Segment()
创建一个新 segment。

Segment(char[] array, int offset, int count)
创建一个引用现有数组的新 segment。

方法摘要

char	charAt(int index) 返回指定索引的 char 值。
Object	clone() 创建一个浅表副本。
char	current() 获取当前位置（由 getIndex() 返回）的字符。
char	first() 将位置设置为 getBeginIndex()，并返回该位置的字符。
int	getBeginIndex() 返回文本的起始索引。
int	getEndIndex() 返回文本的结束索引。
int	getIndex() 返回当前索引。
boolean	isPartialReturn() 指示部分返回有效的标记。
char	last() 将位置设置为 getEndIndex()-1（如果文本为空，则设置为 getEndIndex()），并返回该位置的字符。
int	length() 返回此字符序列的长度。
char	next() 将迭代器的索引加一，并返回新索引处的字符。
char	previous() 将迭代器的索引减一，并返回新索引处的字符。
char	setIndex(int position) 将位置设置为文本中的指定位置，并返回该字符。
void	setPartialReturn(boolean p) 指示部分返回有效的标记。
CharSequence	subSequence(int start, int end) 返回一个新的 CharSequence，它是此序列的子序列。
String	toString() 将 segment 转换为 String。

从类 java.lang.Object 继承的方法

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

字段详细信息

array

public char[] array

这是包含了所需文本的数组。永远不应修改此数组；它只是用来提高效率的。

offset

public int offset

这是所需文件开始处的数组偏移量。

count

public int count

这是构成所需文本的数组元素的数目。

构造方法详细信息

Segment

public Segment()

创建一个新 segment。

Segment

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

创建一个引用现有数组的新 segment。

参数：

array - 要引用的数组

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 转换为 String。

指定者：

接口 CharSequence 中的 toString

覆盖：

类 Object 中的 toString

返回：

字符串

first

public char first()

将位置设置为 getBeginIndex()，并返回该位置的字符。

指定者：

接口 CharacterIterator 中的 first

返回：

文本中的第一个字符，如果文本为空，则返回 DONE

从以下版本开始：

1.3

另请参见：

getBeginIndex()

last

public char last()

将位置设置为 getEndIndex()-1（如果文本为空，则设置为 getEndIndex()），并返回该位置的字符。

指定者：

接口 CharacterIterator 中的 last

返回：

文本中的最后一个字符，如果文本为空，则返回 DONE

从以下版本开始：

1.3

另请参见：

getEndIndex()

current

public char current()

获取当前位置（由 getIndex() 返回）的字符。

指定者：

接口 CharacterIterator 中的 current

返回：

当前位置的字符；如果当前位置已超出文本末尾，则返回 DONE。

从以下版本开始：

1.3

另请参见：

getIndex()

next

public char next()

将迭代器的索引加一，并返回新索引处的字符。如果所得索引大于等于 getEndIndex()，则将当前索引重置为 getEndIndex()，并返回值 DONE。

指定者：

接口 CharacterIterator 中的 next

返回：

新位置的字符；如果该新位置已超出文本范围的末尾，则返回 DONE。

从以下版本开始：

1.3

previous

public char previous()

将迭代器的索引减一，并返回新索引处的字符。如果当前索引为 getBeginIndex()，则新索引仍为 getBeginIndex()，并返回值 DONE。

指定者：

接口 CharacterIterator 中的 previous

返回：

新位置的字符；如果当前位置等于 getBeginIndex()，则返回 DONE。

从以下版本开始：

1.3

setIndex

public char setIndex(int position)

将位置设置为文本中的指定位置，并返回该字符。

指定者：

接口 CharacterIterator 中的 setIndex

参数：

position - 文本中的位置。从 getBeginIndex() 到 getEndIndex() 的有效值范围。如果提供了无效值，则抛出 IllegalArgumentException。

返回：

指定位置的字符；如果指定位置等于 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 值。索引范围是从零到 length() - 1。对于数组索引，序列的第一个 char 值是索引零，下一个是索引一，依此类推。

如果索引指定的 char 值是代理项，则返回代理项的值。

指定者：

接口 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，则返回一个空序列。

指定者：

接口 CharSequence 中的 subSequence

参数：

start - 开始索引（包括）

end - 结束索引（不包括）

返回：

指定的子序列

从以下版本开始：

1.6

clone

public Object clone()

创建一个浅表副本。

指定者：

接口 CharacterIterator 中的 clone

覆盖：

类 Object 中的 clone

返回：

副本

另请参见：

Cloneable