compact1, compact2, compact3

java.text

Class ChoiceFormat

java.lang.Object

java.text.Format

java.text.NumberFormat

java.text.ChoiceFormat

All Implemented Interfaces:

Serializable， Cloneable

public class ChoiceFormat
extends NumberFormat

一个 ChoiceFormat允许你附加格式的数字范围。它一般是用在一个 MessageFormat处理复数。选择与提升的单双打的规定，每个项目指定一个半开区间上的下一个项目：

 X matches j if and only if limit[j] ≤ X < limit[j+1]
 

如果没有比赛，那么无论是第一个或最后一个指标是，取决于数（x）太低或太高。如果限制数组不是在上升的顺序，格式的结果将是不正确的。choiceformat也接受 \u221E等同于无限（INF）。

注： ChoiceFormat不同于其他Format类在你创建一个构造函数ChoiceFormat对象（不是一个getInstance风格的工厂方法）。工厂方法并不需要，因为ChoiceFormat不需要任何复杂的设置，对于一个给定的语言环境。事实上，ChoiceFormat不执行任何特定场所的行为。

创建一个ChoiceFormat时，您必须指定格式的数组和数组的界限。这些数组的长度必须是相同的。例如,

• 限制= { } = { 1,2,3,4,5,6,7
  格式的“太阳”，“一”，“二”，“三”，“四”、“朋友”、“坐”}
• 限制= { 0，1，choiceformat。nextDouble（1）} = {“不
  格式文件”，“一个文件”，“文件”}
  （nextDouble可得到更高一倍，使半开区间。）

这里是一个简单的例子，显示格式和解析：

 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

选择格式不同步。建议为每个线程创建单独的格式实例。如果多个线程同时访问一个格式，则必须在外部同步。

另请参见：

DecimalFormat， MessageFormat， Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.text.NumberFormat

NumberFormat.Field

Field Summary

Fields inherited from class java.text.NumberFormat

FRACTION_FIELD, INTEGER_FIELD

构造方法摘要

构造方法

Constructor and Description
ChoiceFormat(double[] limits, String[] formats) 结构的限制和相应的格式。
ChoiceFormat(String newPattern) 基于模式的限制和相应格式的构造。

方法摘要

Modifier and Type	Method and Description
void	applyPattern(String newPattern) 设置模式。
Object	clone() 覆盖可复制
boolean	equals(Object obj) 两个等式的比较
StringBuffer	format(double number, StringBuffer toAppendTo, FieldPosition status) 带格式化的双返回模式。
StringBuffer	format(long number, StringBuffer toAppendTo, FieldPosition status) 格式专业化。
Object[]	getFormats() 获取构造函数中传递的格式。
double[]	getLimits() 获取构造函数中传递的限制。
int	hashCode() 为消息格式对象生成一个哈希代码。
static double	nextDouble(double d) 发现至少大于 d。
static double	nextDouble(double d, boolean positive) 发现至少大于 d（如果 positive是 true），或最大的双小于 d（如果 positive是 false）。
Number	parse(String text, ParsePosition status) 解析数字输入文本。
static double	previousDouble(double d) 发现最大的双小于 d。
void	setChoices(double[] limits, String[] formats) 设置格式化中使用的选项。
String	toPattern() 获取模式。

Methods inherited from class 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

Methods inherited from class java.text.Format

format, formatToCharacterIterator, parseObject

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ChoiceFormat

public ChoiceFormat(String newPattern)

基于模式的限制和相应格式的构造。

参数

newPattern -新模式字符串

另请参见：

applyPattern(java.lang.String)

ChoiceFormat

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

结构的限制和相应的格式。

参数

limits限制升序

formats相应格式字符串

另请参见：

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

方法详细信息

applyPattern

public void applyPattern(String newPattern)

设置模式。

参数

newPattern看到类的描述。

toPattern

public String toPattern()

获取模式。

结果

模式字符串

setChoices

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

设置格式化中使用的选项。

参数

limits -包含要解析格式的最高价值，并应在升序排序。当格式化X，选择是的我，在极限[我]≤x＜极限[我+ 1 ]。如果限制数组不是在上升的顺序，格式的结果将是不正确的。

formats -你想使用每个限制格式。它们可以是格式化对象或字符串。当格式化对象，如果对象是一个解析，然后（（解析）y）。格式（x）称为。否则tostring()叫Y.。

getLimits

public double[] getLimits()

获取构造函数中传递的限制。

结果

极限。

getFormats

public Object[] getFormats()

获取构造函数中传递的格式。

结果

格式。

format

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

格式专业化。这个方法真的需要 format(double, StringBuffer, FieldPosition)这样范围的渴望，支持只相当于范围可以存储由双。这将永远不会是一个实际的限制。

Specified by:

format 方法重写，继承类 NumberFormat

参数

number -长的数字格式

toAppendTo的StringBuffer的格式化的文本要附加

status -场上位置

结果

格式化字符串

另请参见：

Format.format(java.lang.Object)

format

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

带格式化的双返回模式。

Specified by:

format 方法重写，继承类 NumberFormat

参数

number号码被格式化和取代。

toAppendTo -文本追加。

status忽略任何有用的状态返回。

结果

格式化字符串

另请参见：

Format.format(java.lang.Object)

parse

public Number parse(String text,
                    ParsePosition status)

解析数字输入文本。

Specified by:

parse 方法重写，继承类 NumberFormat

参数

text -原文。

status -输入输出参数。对输入的status.index指出原文应该解析的第一个字符。在退出时，如果没有错误发生，status.index将源文本中的第一个分析的特点。退出的时候，如果真的发生了一个错误，status.index是不变的，status.errorindex将导致解析失败的字符的第一个指标。

结果

表示被解析的数的值的数字。

另请参见：

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

nextDouble

public static final double nextDouble(double d)

发现至少大于 d。如果 NaN，返回相同的值。

用来使半开的时间间隔。

参数

d -参考值

结果

最小的双值大于 d

另请参见：

previousDouble(double)

previousDouble

public static final double previousDouble(double d)

发现最大的双小于 d。如果 NaN，返回相同的值。

参数

d -参考值

结果

最大的双值小于 d

另请参见：

nextDouble(double)

clone

public Object clone()

覆盖可复制

重写：

clone 方法重写，继承类 NumberFormat

结果

这个实例的克隆。

另请参见：

Cloneable

hashCode

public int hashCode()

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

重写：

hashCode 方法重写，继承类 NumberFormat

结果

此对象的哈希代码值。

另请参见：

Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)

equals

public boolean equals(Object obj)

两个等式的比较

重写：

equals 方法重写，继承类 NumberFormat

参数

obj -参考对象的比较。

结果

如果这个对象是 true obj参数相同； false否则。

另请参见：

Object.hashCode()， HashMap

nextDouble

public static double nextDouble(double d,
                                boolean positive)

发现至少大于 d（如果 positive是 true），或最大的双小于 d（如果 positive是 false）。如果 NaN，返回相同的值。不影响浮点旗帜，提供这些成员函数不：双。longbitstodouble（长）双（双）。doubletolongbits双isnan（双）。

参数

d -参考值

positive - true如果至少需要 false否则；

结果

最小或更大的双重价值