模块  java.desktop
软件包  javax.swing.text

Class Segment

  • 实现的所有接口
    CharSequence ， Cloneable ， CharacterIterator 
    public class Segment
extends Object
implements Cloneable, CharacterIterator, CharSequence
    表示文本片段的字符数组的一段。 即使阵列可以直接访问，它也应该被视为不可变的。 这样可以快速访问文本片段，而无需复制字符。 这实际上是一个不受保护的字符串。

    Segment实现了java.text.CharacterIterator接口，以支持与i18n支持一起使用，而无需将文本复制到字符串中。

    • 字段汇总

      字段  
      变量和类型 字段 描述
      char[] array
      这是包含感兴趣文本的数组。
      int count
      这是构成感兴趣文本的数组元素的数量。
      int offset
      这是所需文本开始的数组偏移量。

    • 构造方法摘要

      构造方法  
      构造器 描述
      Segment()
      创建一个新细分。
      Segment​(char[] array, int offset, int count)
      创建引用现有数组的新段。

    • 字段详细信息

      • array

        public char[] array
        这是包含感兴趣文本的数组。 永远不应该修改这个数组; 它仅用于提高效率。

      • offset

        public int offset
        这是所需文本开始的数组偏移量。

      • count

        public int count
        这是构成感兴趣文本的数组元素的数量。

    • 构造方法详细信息

      • Segment

        public Segment()
        创建一个新细分。

      • Segment

        public Segment​(char[] array,
               int offset,
               int count)
        创建引用现有数组的新段。
        参数
        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

      • first

        public char first()
        将位置设置为getBeginIndex（）并返回该位置的字符。
        Specified by:
        first在界面 CharacterIterator
        结果
        文本中的第一个字符，如果文本为空，则为DONE
        从以下版本开始：
        1.3
        另请参见：
        getBeginIndex()

      • last

        public char last()
        将位置设置为getEndIndex（） - 1（如果文本为空，则为getEndIndex（））并返回该位置的字符。
        Specified by:
        last在界面 CharacterIterator
        结果
        文本中的最后一个字符，如果文本为空，则为DONE
        从以下版本开始：
        1.3
        另请参见：
        getEndIndex()

      • current

        public char current()
        获取当前位置的字符（由getIndex（）返回）。
        Specified by:
        current在界面 CharacterIterator
        结果
        当前位置的字符，如果当前位置不在文本末尾，则为DONE。
        从以下版本开始：
        1.3
        另请参见：
        getIndex()

      • next

        public char next()
        将迭代器的索引递增1并返回新索引处的字符。 如果结果索引大于或等于getEndIndex（），则将当前索引重置为getEndIndex（）并返回值DONE。
        Specified by:
        next在界面 CharacterIterator
        结果
        新位置的字符，如果新位置不在文本范围的末尾，则为DONE。
        从以下版本开始：
        1.3

      • previous

        public char previous()
        将迭代器的索引减1并返回新索引处的字符。 如果当前索引是getBeginIndex（），则索引保持在getBeginIndex（）并返回值DONE。
        Specified by:
        previous接口 CharacterIterator
        结果
        新位置的字符，如果当前位置等于getBeginIndex（），则为DONE。
        从以下版本开始：
        1.3

      • setIndex

        public char setIndex​(int position)
        将位置设置为文本中的指定位置并返回该字符。
        Specified by:
        setIndex接口 CharacterIterator
        参数
        position - 文本中的位置。 有效值的范围从getBeginIndex（）到getEndIndex（）。 如果提供了无效值，则抛出IllegalArgumentException。
        结果
        指定位置的字符，如果指定的位置等于getEndIndex（），则为DONE
        从以下版本开始：
        1.3

      • getBeginIndex

        public int getBeginIndex()
        返回文本的起始索引。
        Specified by:
        getBeginIndex在界面 CharacterIterator
        结果
        文本开始的索引。
        从以下版本开始：
        1.3

      • getEndIndex

        public int getEndIndex()
        返回文本的结束索引。 此索引是文本结尾后的第一个字符的索引。
        Specified by:
        getEndIndex在界面 CharacterIterator
        结果
        文本中最后一个字符后面的索引
        从以下版本开始：
        1.3

      • getIndex

        public int getIndex()
        返回当前索引。
        Specified by:
        getIndex在界面 CharacterIterator
        结果
        目前的指数。
        从以下版本开始：
        1.3

      • charAt

        public char charAt​(int index)
        返回指定索引处的char值。 索引范围从0到length() - 1 。 序列的第一个char值在索引0处，下一个在索引1处，依此类推，就像数组索引一样。

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

        Specified by:
        charAt在界面 CharSequence
        参数
        index - 要返回的 char值的索引
        结果
        指定的 char值
        从以下版本开始：
        1.6

      • length

        public int length()
        返回此字符序列的长度。 长度是序列中16位char的数量。
        Specified by:
        length在界面 CharSequence
        结果
        此序列中的 char s的数量
        从以下版本开始：
        1.6

      • subSequence

        public CharSequence subSequence​(int start,
                                int end)
        返回CharSequence ，它是此序列的子序列。 该子序列与所述启动char指定索引处值和与所述结束char在索引值end - 1 。 的长度（以char返回序列的s）为end - start ，因此，如果start == end ，则返回一个空的序列。
        Specified by:
        subSequence接口 CharSequence
        参数
        start - 起始索引，包括
        end - 结束索引，独家
        结果
        指定的子序列
        从以下版本开始：
        1.6