java.text
类 ChoiceFormat

java.lang.Object
  java.text.Format
      java.text.NumberFormat
          java.text.ChoiceFormat

所有已实现的接口：

Serializable, Cloneable

public class ChoiceFormat
     

      extends 
      NumberFormat
     

ChoiceFormat 允许将格式应用到某个范围的数。它通常用于在 MessageFormat 中处理复数。使用按升序排列的 double 列表指定 choice，列表中每一项都指定一个到下一项的半开区间：

当且仅当 limit[j] <= X < limit[j+1] 时，X 匹配 j
 

注：ChoiceFormat 不同于其他 Format 类，因为 ChoiceFormat 对象是通过构造方法创建的（而不是通过 getInstance 样式工厂方法）。工厂方法不是必需的，因为 ChoiceFormat 不要求针对给定语言环境进行任何复杂的设置。事实上，ChoiceFormat 并不实现任何特定于语言环境的行为。

创建 ChoiceFormat 时，必须指定一个 format 数组和一个 limit 数组。这些数组的长度必须相同。例如，

• limits = {1,2,3,4,5,6,7}
  formats = {"Sun","Mon","Tue","Wed","Thur","Fri","Sat"}
• limits = {0, 1, ChoiceFormat.nextDouble(1)}
  formats = {"no files", "one file", "many files"}
  （nextDouble 可用于获取下一个更大的 double 值，以形成半开区间。）

以下是一个显示格式化和解析的简单例子：

 double[] limits = {1,2,3,4,5,6,7};
 String[] dayOfWeekNames = {"Sun","Mon","Tue","Wed","Thur","Fri","Sat"};
 ChoiceFormat form = new ChoiceFormat(limits, dayOfWeekNames);
 ParsePosition status = new ParsePosition(0);
 for (double i = 0.0; i <= 8.0; ++i) {
     status.setIndex(0);
     System.out.println(i + " -> " + form.format(i) + " -> "
                              + form.parse(form.format(i),status));
 }
 

 double[] filelimits = {0,1,2};
 String[] filepart = {"are no files","is one file","are {2} files"};
 ChoiceFormat fileform = new ChoiceFormat(filelimits, filepart);
 Format[] testFormats = {fileform, null, NumberFormat.getInstance()};
 MessageFormat pattform = new MessageFormat("There {0} on {1}");
 pattform.setFormats(testFormats);
 Object[] testArgs = {null, "ADisk", null};
 for (int i = 0; i < 4; ++i) {
     testArgs[0] = new Integer(i);
     testArgs[2] = testArgs[0];
     System.out.println(pattform.format(testArgs));
 }
 

为 ChoiceFormat 对象指定一个模式是相当直接的。例如：

 ChoiceFormat fmt = new ChoiceFormat(
      "-1#is negative| 0#is zero or fraction | 1#is one |1.0<is 1+ |2#is two |2<is more than 2.");
 System.out.println("Formatter Pattern : " + fmt.toPattern());

 System.out.println("Format with -INF : " + fmt.format(Double.NEGATIVE_INFINITY));
 System.out.println("Format with -1.0 : " + fmt.format(-1.0));
 System.out.println("Format with 0 : " + fmt.format(0));
 System.out.println("Format with 0.9 : " + fmt.format(0.9));
 System.out.println("Format with 1.0 : " + fmt.format(1));
 System.out.println("Format with 1.5 : " + fmt.format(1.5));
 System.out.println("Format with 2 : " + fmt.format(2));
 System.out.println("Format with 2.1 : " + fmt.format(2.1));
 System.out.println("Format with NaN : " + fmt.format(Double.NaN));
 System.out.println("Format with +INF : " + fmt.format(Double.POSITIVE_INFINITY));
 

 
   

    
   Format with -INF : is negative
   Format with -1.0 : is negative
   Format with 0 : is zero or fraction
   Format with 0.9 : is zero or fraction
   Format with 1.0 : is one
   Format with 1.5 : is 1+
   Format with 2 : is two
   Format with 2.1 : is more than 2.
   Format with NaN : is negative
   Format with +INF : is more than 2.
 
   

Synchronization

Choice 格式不是同步的。建议为每个线程创建单独的格式实例。如果多个线程并发访问一个格式，则它必须保持外部同步。

另请参见：

DecimalFormat, MessageFormat, 序列化表格

ChoiceFormat

public ChoiceFormat(String newPattern)

根据 limit 和相应的 format（基于模式）构造。

另请参见：

applyPattern(java.lang.String)

ChoiceFormat

public ChoiceFormat(double[] limits,
                    String[] formats)

根据 limit 和相应的 format 构造。

另请参见：

setChoices(double[], java.lang.String[])

applyPattern

public void applyPattern(String newPattern)

设置模式。

参数：

newPattern - 参见类描述。

toPattern

public String toPattern()

获取模式。

setChoices

public void setChoices(double[] limits,
                       String[] formats)

设置要在格式化中使用的 choice。

参数：

limits - 包含要使用该格式进行解析的最大值，应该按升序排列。格式化 X 时，如果 limit[i] <= X < limit[i+1]，则 choice 为 i。如果 limit 数组不按升序排列，则格式化的结果将不正确。

formats - 要为每个 limit 使用的格式。格式可以是 Format 对象或 String。用对象 Y 格式化时，如果该对象是一个 NumberFormat，则调用 ((NumberFormat) Y).format(X)。否则调用 Y.toString()。

getLimits

public double[] getLimits()

获取传入构造方法的 limit。

返回：

limit。

getFormats

public Object[] getFormats()

获取传入构造方法的 format。

返回：

format。

format

public StringBuffer format(long number,
                           StringBuffer toAppendTo,
                           FieldPosition status)

特殊格式。此方法真正调用 format(double, StringBuffer, FieldPosition)，这样，受支持的 long 范围只等于 double 存储的范围。这不是一个实用的限制。

指定者：

类 NumberFormat 中的 format

另请参见：

Format.format(java.lang.Object)

format

public StringBuffer format(double number,
                           StringBuffer toAppendTo,
                           FieldPosition status)

返回带已格式化 double 的模式。

指定者：

类 NumberFormat 中的 format

参数：

number - 要格式化或替换的数。

toAppendTo - 将文本添加到的地方。

status - 忽略，无有用的状态返回。

另请参见：

Format.format(java.lang.Object)

parse

public Number parse(String text,
                    ParsePosition status)

解析输入文本中的一个 Number。

指定者：

类 NumberFormat 中的 parse

参数：

text - 源文本。

status - 一个输入输出参数。输入时，status.index 字段指示应该解析的源文本中的第一个字符。退出时，如果没有发生错误，则将 status.index 设置为源文本中第一个未解析的字符。退出时，如果发生了错误，则 status.index 保持不变，将 status.errorIndex 设置为引起解析失败的第一个字符的索引。

返回：

一个表示已解析数值的 Number。

另请参见：

NumberFormat.isParseIntegerOnly(), Format.parseObject(java.lang.String, java.text.ParsePosition)

nextDouble

public static final double nextDouble(double d)

查找大于 d 的最小 double 值。如果为 NaN，则返回相同的值。

用于形成半开区间。

另请参见：

previousDouble(double)

previousDouble

public static final double previousDouble(double d)

查找小于 d 的最大 double 值。如果为 NaN，则返回相同的值。

另请参见：

nextDouble(double)

clone

public Object clone()

重写 Cloneable

覆盖：

类 NumberFormat 中的 clone

返回：

此实例的一个副本。

另请参见：

Cloneable

hashCode

public int hashCode()

为消息格式对象生成哈希码。

覆盖：

类 NumberFormat 中的 hashCode

返回：

此对象的一个哈希码值。

另请参见：

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

equals

public boolean equals(Object obj)

两个对象之间的相等性比较。

覆盖：

类 NumberFormat 中的 equals

参数：

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

返回：

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

另请参见：

Object.hashCode(), Hashtable

nextDouble

public static double nextDouble(double d,
                                boolean positive)

查找大于 d 的最小 double 值（如果 positive == true），或者小于 d 的最大值（如果 positive == false）。如果为 NaN，则返回相同的值。 如果这些成员函数不调用以下方法，就不会影响浮点标志： Double.longBitsToDouble(long) Double.doubleToLongBits(double) Double.isNaN(double)