Module  java.base
软件包  java.text

Class FieldPosition


  • public class FieldPosition
extends Object
    FieldPosition是由Format及其子类使用的简单类，用于标识格式化输出中的字段。 可以通过两种方式识别字段：
    • 一个整数常数，其名称通常以_FIELD 。 这些常数在Format的各个子类中Format 。
    • 以Format.Field常数，见ERA_FIELD及其朋友在DateFormat为例。

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

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

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

    从以下版本开始：
    1.1
    另请参见：
    Format

    • 构造方法详细信息

      • 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)
        设置开始索引。 供格式的子类使用。
        参数
        bi - 开始索引
        从以下版本开始：
        1.2

      • setEndIndex

        public void setEndIndex​(int ei)
        设置结束索引。 供格式的子类使用。
        参数
        ei - 结束索引
        从以下版本开始：
        1.2

      • equals

        public boolean equals​(Object obj)
        覆盖等于
        重写：
        equals在 Object
        参数
        obj - 与之比较的参考对象。
        结果
        true如果此对象与obj参数相同; 否则为false 。
        另请参见：
        Object.hashCode() ， HashMap

      • toString

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