java.text
类 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。

另请参见：

Format

FieldPosition

public FieldPosition(int field)

为给定字段创建一个 FieldPosition 对象。字段由常量标识，在不同的 Format 子类中，常量名称一般以 _FIELD 结尾。

另请参见：

NumberFormat.INTEGER_FIELD, NumberFormat.FRACTION_FIELD, DateFormat.YEAR_FIELD, DateFormat.MONTH_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 标识。当 attribute 不为 null 时，需要使用 Field 的 Format 子类应当优先考虑 attribute 而忽略 fieldID。不过，旧的 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 的子类使用。

从以下版本开始：

1.2

setEndIndex

public void setEndIndex(int ei)

Sets the end index.由 Format 的子类使用。

从以下版本开始：

1.2

equals

public boolean equals(Object obj)

重写 equals

覆盖：

类 Object 中的 equals

参数：

obj - 要与之比较的引用对象。

返回：

如果此对象与 obj 参数相同，则返回 true；否则返回 false。

另请参见：

Object.hashCode(), Hashtable

hashCode

public int hashCode()

返回此 FieldPosition 的哈希码。

覆盖：

类 Object 中的 hashCode

返回：

此对象的哈希码值

另请参见：

Object.equals(java.lang.Object), Hashtable

toString

public String toString()

返回此 FieldPosition 的字符串表示形式。

覆盖：

类 Object 中的 toString

返回：

此对象的字符串表示形式