模块 java.base
包 java.text

类 FieldPosition

java.lang.Object
java.text.FieldPosition
public class FieldPosition extends Object
FieldPosition 是Format 及其子类用来识别格式化输出中的字段的简单类。可以通过两种方式识别字段：
  • 通过一个整数常量，其名称通常以 _FIELD 结尾。这些常量在 Format 的各个子类中定义。
  • 通过 Format.Field 常数，请参阅 ERA_FIELD 及其在 DateFormat 中的朋友的示例。

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

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

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

自从：
1.1
参见：

  • 构造方法详细信息

    • 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 标识。 Format 知道 Field 的子类应该优先于 attribute 并忽略 fieldID 如果 attribute 不为空。但是，较旧的 Format 子类可能不知道 Field 并依赖 fieldID 。如果字段没有对应的整型常量，fieldID应该是-1。
      参数：
      attribute - 标识字段的 Format.Field 常量
      fieldID - 标识字段的整数常量
      自从：
      1.4

  • 方法详情

    • 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 在类 Object 中
      参数：
      obj - 要比较的参考对象。
      返回：
      true 如果此对象与 obj 参数相同； false否则。
      参见：

    • hashCode

      public int hashCode()
      返回此 FieldPosition 的哈希码。
      重写：
      hashCode 在类 Object 中
      返回：
      此对象的哈希码值
      参见：

    • toString

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