模块 java.desktop
包 javax.swing.text

类 Segment

java.lang.Object
javax.swing.text.Segment
所有已实现的接口：
CharSequence , Cloneable , CharacterIterator
public class Segment extends Object implements Cloneable , CharacterIterator , CharSequence
表示一段文本的字符数组的一段。即使数组可以直接访问，它也应该被视为不可变的。这可以快速访问文本片段，而无需在字符周围进行复制。这实际上是一个不受保护的字符串。

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

  • 字段摘要

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

    在接口 java.text.CharacterIterator 中声明的字段

    DONE

  • 构造方法总结

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

  • 方法总结

    修饰符和类型
    方法
    描述
    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()
    将迭代器的索引递增 1 并返回新索引处的字符。
    char
    previous()
    将迭代器的索引减一并返回新索引处的字符。
    char
    setIndex(int position)
    将位置设置为文本中的指定位置并返回该字符。
    void
    setPartialReturn(boolean p)
    指示部分返回有效的标志。
    CharSequence
    subSequence(int start, int end)
    返回一个 CharSequence，它是这个序列的子序列。
    String
    toString()
    将段转换为字符串。

    在类 java.lang.Object 中声明的方法

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

    在接口 java.lang.CharSequence 中声明的方法

    chars, codePoints, isEmpty

  • 字段详细信息

    • 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)
      指示部分返回有效的标志。如果该标志为真，则接口方法 Document.getText(position,length,Segment) 的实现应返回尽可能多的文本而不进行复制。该标志的默认状态为 false，这将导致 Document.getText(position,length,Segment) 提供它始终具有的相同返回行为，这可能会也可能不会复制文本，具体取决于请求。
      参数：
      p - 部分回报是否有效。
      自从：
      1.4

    • isPartialReturn

      public boolean isPartialReturn()
      指示部分返回有效的标志。
      返回：
      部分回报是否有效。
      自从：
      1.4

    • toString

      public String  toString()
      将段转换为字符串。
      指定者：
      toString 在接口 CharSequence 中
      重写：
      toString 在类 Object 中
      返回：
      字符串

    • first

      public char first()
      将位置设置为 getBeginIndex() 并返回该位置的字符。
      指定者：
      first 在接口 CharacterIterator 中
      返回：
      文本中的第一个字符，如果文本为空则为 DONE
      自从：
      1.3
      参见：

    • last

      public char last()
      将位置设置为 getEndIndex()-1（如果文本为空则为 getEndIndex()）并返回该位置的字符。
      指定者：
      last 在接口 CharacterIterator 中
      返回：
      文本中的最后一个字符，如果文本为空则为 DONE
      自从：
      1.3
      参见：

    • current

      public char current()
      获取当前位置的字符（由 getIndex() 返回）。
      指定者：
      current 在接口 CharacterIterator 中
      返回：
      当前位置的字符，如果当前位置不在文本末尾，则返回 DONE。
      自从：
      1.3
      参见：

    • next

      public char next()
      将迭代器的索引递增 1 并返回新索引处的字符。如果生成的索引大于或等于 getEndIndex()，则当前索引将重置为 getEndIndex() 并返回 DONE 值。
      指定者：
      next 在接口 CharacterIterator 中
      返回：
      新位置的字符，如果新位置超出文本范围的末尾，则返回 DONE。
      自从：
      1.3

    • previous

      public char previous()
      将迭代器的索引减一并返回新索引处的字符。如果当前索引为 getBeginIndex()，则索引保持在 getBeginIndex() 并返回 DONE 值。
      指定者：
      previous 在接口 CharacterIterator 中
      返回：
      新位置的字符，如果当前位置等于 getBeginIndex()，则完成。
      自从：
      1.3

    • setIndex

      public char setIndex(int position)
      将位置设置为文本中的指定位置并返回该字符。
      指定者：
      setIndex 在接口 CharacterIterator 中
      参数：
      position - 文本中的位置。有效值范围从 getBeginIndex() 到 getEndIndex()。如果提供了无效值，则会抛出 IllegalArgumentException。
      返回：
      指定位置的字符，如果指定位置等于 getEndIndex()，则为 DONE
      自从：
      1.3

    • getBeginIndex

      public int getBeginIndex()
      返回文本的起始索引。
      指定者：
      getBeginIndex 在接口 CharacterIterator 中
      返回：
      文本开始的索引。
      自从：
      1.3

    • getEndIndex

      public int getEndIndex()
      返回文本的结束索引。该索引是文本末尾后的第一个字符的索引。
      指定者：
      getEndIndex 在接口 CharacterIterator 中
      返回：
      文本中最后一个字符之后的索引
      自从：
      1.3

    • getIndex

      public int getIndex()
      返回当前索引。
      指定者：
      getIndex 在接口 CharacterIterator 中
      返回：
      当前索引。
      自从：
      1.3

    • charAt

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

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

      指定者：
      charAt 在接口 CharSequence 中
      参数：
      index - 要返回的 char 值的索引
      返回：
      指定的 char 值
      自从：
      1.6

    • length

      public int length()
      返回此字符序列的长度。长度是序列中 16 位 char 的个数。
      指定者：
      length 在接口 CharSequence 中
      返回：
      此序列中 char 的数量
      自从：
      1.6

    • subSequence

      public CharSequence  subSequence(int start, int end)
      返回一个 CharSequence，它是这个序列的子序列。子序列以指定索引处的 char 值开始，以索引 end - 1 处的 char 值结束。返回序列的长度（以 char s 为单位）为 end - start ，因此如果为 start == end 则返回一个空序列。
      指定者：
      subSequence 在接口 CharSequence 中
      参数：
      start - 起始索引，包括在内
      end - 结束索引，独占
      返回：
      指定的子序列
      自从：
      1.6

    • clone

      public Object  clone()
      创建一个浅拷贝。
      指定者：
      clone 在接口 CharacterIterator 中
      重写：
      clone 在类 Object 中
      返回：
      副本
      参见：