当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

ChoiceFormat (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM Platform Standard Ed. 6
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

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
 

如果不匹配，则根据数 (X) 的是太小还是太大，选择使用第一个或最后一个索引。如果 limit 数组不按升序排列，则格式化的结果将不正确。ChoiceFormat 还接受 \u221E（等同于无穷大 (INF)）。

注：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, 序列化表格

---

嵌套类摘要

 

从类 java.text.NumberFormat 继承的嵌套类/接口
NumberFormat.Field

 

字段摘要

 

从类 java.text.NumberFormat 继承的字段
FRACTION_FIELD, INTEGER_FIELD

 

构造方法摘要
ChoiceFormat(double[] limits, String[] formats)           根据 limit 和相应的 format 构造。
ChoiceFormat(String newPattern)           根据 limit 和相应的 format（基于模式）构造。

 

方法摘要
void	applyPattern(String newPattern)           设置模式。
Object	clone()           重写 Cloneable
boolean	equals(Object obj)           两个对象之间的相等性比较。
StringBuffer	format(double number, StringBuffer toAppendTo, FieldPosition status)           返回带已格式化 double 的模式。
StringBuffer	format(long number, StringBuffer toAppendTo, FieldPosition status)           特殊格式。
Object[]	getFormats()           获取传入构造方法的 format。
double[]	getLimits()           获取传入构造方法的 limit。
int	hashCode()           为消息格式对象生成哈希码。
static double	nextDouble(double d)           查找大于 d 的最小 double 值。
static double	nextDouble(double d, boolean positive)           查找大于 d 的最小 double 值（如果 positive == true），或者小于 d 的最大值（如果 positive == false）。
Number	parse(String text, ParsePosition status)           解析输入文本中的一个 Number。
static double	previousDouble(double d)           查找小于 d 的最大 double 值。
void	setChoices(double[] limits, String[] formats)           设置要在格式化中使用的 choice。
String	toPattern()           获取模式。

 

从类 java.text.NumberFormat 继承的方法

format, format, format, getAvailableLocales, getCurrency, getCurrencyInstance, getCurrencyInstance, getInstance, getInstance, getIntegerInstance, getIntegerInstance, getMaximumFractionDigits, getMaximumIntegerDigits, getMinimumFractionDigits, getMinimumIntegerDigits, getNumberInstance, getNumberInstance, getPercentInstance, getPercentInstance, getRoundingMode, isGroupingUsed, isParseIntegerOnly, parse, parseObject, setCurrency, setGroupingUsed, setMaximumFractionDigits, setMaximumIntegerDigits, setMinimumFractionDigits, setMinimumIntegerDigits, setParseIntegerOnly, setRoundingMode

 

从类 java.text.Format 继承的方法
format, formatToCharacterIterator, parseObject

 

从类 java.lang.Object 继承的方法
finalize, getClass, notify, notifyAll, toString, wait, wait, wait

 

构造方法详细信息

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)

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM Platform Standard Ed. 6
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。