TopBlend: Here is the first difference. There are 9 differences. is old. is new.

java.text
Class DecimalFormatSymbols


java.lang.Object
  extended by java.text.DecimalFormatSymbols
All Implemented Interfaces:
Serializable , Cloneable 
public final class DecimalFormatSymbols
extends Object
implements Cloneable, Serializable

This class represents the set of symbols (such as the decimal separator, the grouping separator, and so on) needed by DecimalFormat to format numbers. DecimalFormat creates for itself an instance of DecimalFormatSymbols from its locale data. If you need to change any of these symbols, you can get the DecimalFormatSymbols object from your DecimalFormat and modify it.

See Also:
Locale , DecimalFormat , Serialized Form

Constructor Summary
DecimalFormatSymbols ()
          Create a DecimalFormatSymbols object for the default locale.
DecimalFormatSymbols ( Locale  locale)
          Create a DecimalFormatSymbols object for the given locale.
 
Method Summary
  Object clone ()
          Standard override.
 boolean equals ( Object  obj)
          Override equals.
static  Locale getAvailableLocales ()
          Returns an array of all locales for which the getInstance methods of this class can return localized instances.
  Currency getCurrency ()
          Gets the currency of these DecimalFormatSymbols.
  String getCurrencySymbol ()
          Returns the currency symbol for the currency of these DecimalFormatSymbols in their locale.
 char getDecimalSeparator ()
          Gets the character used for decimal sign.
 char getDigit ()
          Gets the character used for a digit in a pattern.
  String getExponentSeparator ()
          Returns the string used to separate the mantissa from the exponent.
 char getGroupingSeparator ()
          Gets the character used for thousands separator.
  String getInfinity ()
          Gets the string used to represent infinity.
static  DecimalFormatSymbols getInstance ()
          Gets the DecimalFormatSymbols instance for the default locale.
static  DecimalFormatSymbols getInstance ( Locale
          Gets the DecimalFormatSymbols instance for the specified locale.
  String getInternationalCurrencySymbol ()
          Returns the ISO 4217 currency code of the currency of these DecimalFormatSymbols.
 char getMinusSign ()
          Gets the character used to represent minus sign.
 char getMonetaryDecimalSeparator ()
          Returns the monetary decimal separator.
  String getNaN ()
          Gets the string used to represent "not a number".
 char getPatternSeparator ()
          Gets the character used to separate positive and negative subpatterns in a pattern.
 char getPercent ()
          Gets the character used for percent sign.
 char getPerMill ()
          Gets the character used for per mille sign.
 char getZeroDigit ()
          Gets the character used for zero.
 int hashCode ()
          Override hashCode.
 void setCurrency ( Currency  currency)
          Sets the currency of these DecimalFormatSymbols.
 void setCurrencySymbol ( String  currency)
          Sets the currency symbol for the currency of these DecimalFormatSymbols in their locale.
 void setDecimalSeparator (char decimalSeparator)
          Sets the character used for decimal sign.
 void setDigit (char digit)
          Sets the character used for a digit in a pattern.
 void setExponentSeparator ( String
          Sets the string used to separate the mantissa from the exponent.
 void setGroupingSeparator (char groupingSeparator)
          Sets the character used for thousands separator.
 void setInfinity ( String  infinity)
          Sets the string used to represent infinity.
 void setInternationalCurrencySymbol ( String  currencyCode)
          Sets the ISO 4217 currency code of the currency of these DecimalFormatSymbols.
 void setMinusSign (char minusSign)
          Sets the character used to represent minus sign.
 void setMonetaryDecimalSeparator (char sep)
          Sets the monetary decimal separator.
 void setNaN ( String  NaN)
          Sets the string used to represent "not a number".
 void setPatternSeparator (char patternSeparator)
          Sets the character used to separate positive and negative subpatterns in a pattern.
 void setPercent (char percent)
          Sets the character used for percent sign.
 void setPerMill (char perMill)
          Sets the character used for per mille sign.
 void setZeroDigit (char zeroDigit)
          Sets the character used for zero.
 
Methods inherited from class java.lang. Object
finalize , getClass , notify , notifyAll , toString , wait , wait , wait
 

Constructor Detail

DecimalFormatSymbols


public DecimalFormatSymbols()
Create a DecimalFormatSymbols object for the default locale. This constructor can only construct instances for the locales supported by the Java runtime environment, not for those supported by installed DecimalFormatSymbolsProvider implementations. For full locale coverage, use the getInstance method.

DecimalFormatSymbols


public DecimalFormatSymbols(Locale locale)
Create a DecimalFormatSymbols object for the given locale. This constructor can only construct instances for the locales supported by the Java runtime environment, not for those supported by installed DecimalFormatSymbolsProvider implementations. For full locale coverage, use the getInstance method.

Throws:
NullPointerException - if locale is null
Method Detail

getAvailableLocales 


 
public static Locale[] getAvailableLocales ()
Returns an array of all locales for which the getInstance methods of this class can return localized instances. The returned array represents the union of locales supported by the Java runtime and by installed DecimalFormatSymbolsProvider implementations. It must contain at least a Locale instance equal to Locale.US .

Returns:
An array of locales for which localized DecimalFormatSymbols instances are available.
Since:
1.6

getInstance 


 
public static final DecimalFormatSymbolsgetInstance ()
Gets the DecimalFormatSymbols instance for the default locale. This method provides access to DecimalFormatSymbols instances for locales supported by the Java runtime itself as well as for those supported by installed DecimalFormatSymbolsProvider implementations.

Returns:
a DecimalFormatSymbols instance.
Since:
1.6

getInstance 


 
public static final DecimalFormatSymbolsgetInstance ( Locale locale)
Gets the DecimalFormatSymbols instance for the specified locale. This method provides access to DecimalFormatSymbols instances for locales supported by the Java runtime itself as well as for those supported by installed DecimalFormatSymbolsProvider implementations.

Parameters:
locale - the desired locale.
Returns:
a DecimalFormatSymbols instance.
Throws:
NullPointerException - if locale is null
Since:
1.6

getZeroDigit


public char getZeroDigit()
Gets the character used for zero. Different for Arabic, etc.

setZeroDigit


public void setZeroDigit(char zeroDigit)
Sets the character used for zero. Different for Arabic, etc.

getGroupingSeparator


public char getGroupingSeparator()
Gets the character used for thousands separator. Different for French, etc.

setGroupingSeparator


public void setGroupingSeparator(char groupingSeparator)
Sets the character used for thousands separator. Different for French, etc.

getDecimalSeparator


public char getDecimalSeparator()
Gets the character used for decimal sign. Different for French, etc.

setDecimalSeparator


public void setDecimalSeparator(char decimalSeparator)
Sets the character used for decimal sign. Different for French, etc.

getPerMill


public char getPerMill()
Gets the character used for per mille sign. Different for Arabic, etc.

setPerMill


public void setPerMill(char perMill)
Sets the character used for per mille sign. Different for Arabic, etc.

getPercent


public char getPercent()
Gets the character used for percent sign. Different for Arabic, etc.

setPercent


public void setPercent(char percent)
Sets the character used for percent sign. Different for Arabic, etc.

getDigit


public char getDigit()
Gets the character used for a digit in a pattern.

setDigit


public void setDigit(char digit)
Sets the character used for a digit in a pattern.

getPatternSeparator


public char getPatternSeparator()
Gets the character used to separate positive and negative subpatterns in a pattern.

setPatternSeparator


public void setPatternSeparator(char patternSeparator)
Sets the character used to separate positive and negative subpatterns in a pattern.

getInfinity


public String getInfinity()
Gets the string used to represent infinity. Almost always left unchanged.

setInfinity


public void setInfinity(String infinity)
Sets the string used to represent infinity. Almost always left unchanged.

getNaN


public String getNaN()
Gets the string used to represent "not a number". Almost always left unchanged.

setNaN


public void setNaN(String NaN)
Sets the string used to represent "not a number". Almost always left unchanged.

getMinusSign


public char getMinusSign()
Gets the character used to represent minus sign. If no explicit negative format is specified, one is formed by prefixing minusSign to the positive format.

setMinusSign


public void setMinusSign(char minusSign)
Sets the character used to represent minus sign. If no explicit negative format is specified, one is formed by prefixing minusSign to the positive format.

getCurrencySymbol


public String getCurrencySymbol()
Returns the currency symbol for the currency of these DecimalFormatSymbols in their locale.

Since:
1.2

setCurrencySymbol


public void setCurrencySymbol(String currency)
Sets the currency symbol for the currency of these DecimalFormatSymbols in their locale.

Since:
1.2

getInternationalCurrencySymbol


public String getInternationalCurrencySymbol()
Returns the ISO 4217 currency code of the currency of these DecimalFormatSymbols.

Since:
1.2

setInternationalCurrencySymbol


public void setInternationalCurrencySymbol(String currencyCode)
Sets the ISO 4217 currency code of the currency of these DecimalFormatSymbols. If the currency code is valid (as defined by Currency.getInstance ), this also sets the currency attribute to the corresponding Currency instance and the currency symbol attribute to the currency's symbol in the DecimalFormatSymbols' locale. If the currency code is not valid, then the currency attribute is set to null and the currency symbol attribute is not modified.

Since:
1.2
See Also:
setCurrency(java.util.Currency) , setCurrencySymbol(java.lang.String)

getCurrency


public Currency getCurrency()
Gets the currency of these DecimalFormatSymbols. May be null if the currency symbol attribute was previously set to a value that's not a valid ISO 4217 currency code.

Returns:
the currency used, or null
Since:
1.4

setCurrency


public void setCurrency(Currency currency)
Sets the currency of these DecimalFormatSymbols. This also sets the currency symbol attribute to the currency's symbol in the DecimalFormatSymbols' locale, and the international currency symbol attribute to the currency's ISO 4217 currency code.

Parameters:
currency - the new currency to be used
Throws:
NullPointerException - if currency is null
Since:
1.4
See Also:
setCurrencySymbol(java.lang.String) , setInternationalCurrencySymbol(java.lang.String)

getMonetaryDecimalSeparator


public char getMonetaryDecimalSeparator()
Returns the monetary decimal separator.

Since:
1.2

setMonetaryDecimalSeparator


public void setMonetaryDecimalSeparator(char sep)
Sets the monetary decimal separator.

Since:
1.2

getExponentSeparator 


 
public StringgetExponentSeparator ()
Returns the string used to separate the mantissa from the exponent. Examples: "x10^" for 1.23x10^4, "E" for 1.23E4.

Returns:
the exponent separator string
Since:
1.6
See Also:
setExponentSeparator(java.lang.String)

setExponentSeparator 


 
public void setExponentSeparator ( String exp)
Sets the string used to separate the mantissa from the exponent. Examples: "x10^" for 1.23x10^4, "E" for 1.23E4.

Parameters:
exp - the exponent separator string
Throws:
NullPointerException - if exp is null
Since:
1.6
See Also:
getExponentSeparator()

clone


public Object clone()
Standard override.

Overrides:
clone in class Object
Returns:
a clone of this instance.
See Also:
Cloneable

equals


public boolean equals(Object obj)
Override equals.

Overrides:
equals in class Object
Parameters:
obj - the reference object with which to compare.
Returns:
true if this object is the same as the obj argument; false otherwise.
See Also:
Object.hashCode() , Hashtable

hashCode


public int hashCode()
Override hashCode.

Overrides:
hashCode in class Object
Returns:
a hash code value for this object.
See Also:
Object.equals(java.lang.Object) , Hashtable