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

Class Segment

  • 实现的所有接口
    CharSequenceCloneableCharacterIterator

    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