Module java.base
Package java.text

Class FieldPosition

java.lang.Object
java.text.FieldPosition
public class FieldPosition extends Object
FieldPosition是一个简单的类，被Format及其子类用于标识格式化输出中的字段。字段可以通过两种方式进行标识：
  • 通过整数常量，其名称通常以_FIELD结尾。这些常量在Format的各个子类中定义。
  • 通过Format.Field常量，例如在DateFormat中查看ERA_FIELD及其相关常量的示例。

FieldPosition使用两个索引跟踪格式化输出中字段的位置：字段的第一个字符的索引和字段的最后一个字符的索引。

各种Format类中的format方法的一个版本需要一个FieldPosition对象作为参数。您可以使用这个format方法执行部分格式化或获取关于格式化输出的信息（例如字段的位置）。

如果您对格式化字符串中所有属性的位置感兴趣，请使用Format方法formatToCharacterIterator。

自版本:
1.1
参见:

  • Constructor Details

    • FieldPosition

      public FieldPosition(int field)
      为给定字段创建一个FieldPosition对象。字段通过在Format的各个子类中定义的常量进行标识，这些常量的名称通常以_FIELD结尾。
      参数:
      field - 字段标识符
      参见:

    • FieldPosition

      public FieldPosition(Format.Field attribute)
      为给定字段常量创建一个FieldPosition对象。字段通过在各个Format子类中定义的常量进行标识。这相当于调用new FieldPosition(attribute, -1)。
      参数:
      attribute - 标识字段的Format.Field常量
      自版本:
      1.4

    • FieldPosition

      public FieldPosition(Format.Field attribute, int fieldID)
      为给定字段创建一个FieldPosition对象。字段通过Field的子类中的属性常量以及Format的子类定义的整数字段ID进行标识。Field意识到的Format子类应优先考虑attribute并忽略fieldID（如果attribute不为null）。但是，旧的Format子类可能不了解Field并依赖于fieldID。如果字段没有对应的整数常量，则fieldID应为-1。
      参数:
      attribute - 标识字段的Format.Field常量
      fieldID - 标识字段的整数常量
      自版本:
      1.4

  • Method Details

    • getFieldAttribute

      public Format.Field getFieldAttribute()
      从Field的子类中返回字段标识符作为属性常量。如果字段仅通过整数字段ID指定，则可能返回null。
      返回:
      字段的标识符
      自版本:
      1.4

    • getField

      public int getField()
      检索字段标识符。
      返回:
      字段标识符

    • getBeginIndex

      public int getBeginIndex()
      检索请求字段中第一个字符的索引。
      返回:
      开始索引

    • getEndIndex

      public int getEndIndex()
      检索请求字段中最后一个字符后面的索引。
      返回:
      结束索引

    • setBeginIndex

      public void setBeginIndex(int bi)
      设置开始索引。供Format的子类使用。
      参数:
      bi - 开始索引
      自版本:
      1.2

    • setEndIndex

      public void setEndIndex(int ei)
      设置结束索引。供Format的子类使用。
      参数:
      ei - 结束索引
      自版本:
      1.2

    • equals

      public boolean equals(Object obj)
      覆盖equals方法
      覆盖:
      equals 在类 Object中
      参数:
      obj - 要比较的参考对象。
      返回:
      如果此对象与obj参数相同，则返回true；否则返回false。
      参见:

    • hashCode

      public int hashCode()
      返回此FieldPosition的哈希码。
      覆盖:
      hashCode 在类 Object中
      返回:
      此对象的哈希码值
      参见:

    • toString

      public String toString()
      返回此FieldPosition的字符串表示形式。
      覆盖:
      toString 在类 Object中
      返回:
      此对象的字符串表示形式