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