DecimalFormatSymbols.java
// © 2016 and later: Unicode, Inc. and others.
// License & terms of use: http://www.unicode.org/copyright.html
/*
*******************************************************************************
* Copyright (C) 1996-2016, International Business Machines Corporation and
* others. All Rights Reserved.
*******************************************************************************
*/
package com.ibm.icu.text;
import com.ibm.icu.impl.CacheBase;
import com.ibm.icu.impl.CurrencyData;
import com.ibm.icu.impl.CurrencyData.CurrencyDisplayInfo;
import com.ibm.icu.impl.CurrencyData.CurrencyFormatInfo;
import com.ibm.icu.impl.CurrencyData.CurrencySpacingInfo;
import com.ibm.icu.impl.ICUData;
import com.ibm.icu.impl.ICUResourceBundle;
import com.ibm.icu.impl.SoftCache;
import com.ibm.icu.impl.UResource;
import com.ibm.icu.util.Currency;
import com.ibm.icu.util.ICUCloneNotSupportedException;
import com.ibm.icu.util.ULocale;
import com.ibm.icu.util.ULocale.Category;
import com.ibm.icu.util.UResourceBundle;
import java.io.IOException;
import java.io.ObjectInputStream;
import java.io.Serializable;
import java.util.Arrays;
import java.util.Locale;
import java.util.MissingResourceException;
/**
* {@icuenhanced java.text.DecimalFormatSymbols}.{@icu _usage_}
*
* <p>This class represents the set of symbols (such as the decimal separator, the grouping
* separator, and so on) needed by <code>DecimalFormat</code> to format numbers. <code>DecimalFormat
* </code> creates for itself an instance of <code>DecimalFormatSymbols</code> from its locale data.
* If you need to change any of these symbols, you can get the <code>DecimalFormatSymbols</code>
* object from your <code>DecimalFormat</code> and modify it.
*
* @see java.util.Locale
* @see DecimalFormat
* @author Mark Davis
* @author Alan Liu
* @stable ICU 2.0
*/
public class DecimalFormatSymbols implements Cloneable, Serializable {
/**
* Creates a DecimalFormatSymbols object for the default <code>FORMAT</code> locale.
*
* @see Category#FORMAT
* @stable ICU 2.0
*/
public DecimalFormatSymbols() {
this(ULocale.getDefault(Category.FORMAT));
}
/**
* Creates a DecimalFormatSymbols object for the given locale.
*
* @param locale the locale
* @stable ICU 2.0
*/
public DecimalFormatSymbols(Locale locale) {
this(ULocale.forLocale(locale));
}
/**
* {@icu} Creates a DecimalFormatSymbols object for the given locale.
*
* @param locale the locale
* @stable ICU 3.2
*/
public DecimalFormatSymbols(ULocale locale) {
initialize(locale, null);
}
private DecimalFormatSymbols(Locale locale, NumberingSystem ns) {
this(ULocale.forLocale(locale), ns);
}
private DecimalFormatSymbols(ULocale locale, NumberingSystem ns) {
initialize(locale, ns);
}
/**
* Returns a DecimalFormatSymbols instance for the default locale.
*
* <p><strong>Note:</strong> Unlike <code>java.text.DecimalFormatSymbols#getInstance</code>,
* this method simply returns <code>new com.ibm.icu.text.DecimalFormatSymbols()</code>. ICU
* currently does not support <code>DecimalFormatSymbolsProvider</code>, which was introduced in
* Java 6.
*
* @return A DecimalFormatSymbols instance.
* @stable ICU 3.8
*/
public static DecimalFormatSymbols getInstance() {
return new DecimalFormatSymbols();
}
/**
* Returns a DecimalFormatSymbols instance for the given locale.
*
* <p><strong>Note:</strong> Unlike <code>java.text.DecimalFormatSymbols#getInstance</code>,
* this method simply returns <code>new com.ibm.icu.text.DecimalFormatSymbols(locale)</code>.
* ICU currently does not support <code>DecimalFormatSymbolsProvider</code>, which was
* introduced in Java 6.
*
* @param locale the locale.
* @return A DecimalFormatSymbols instance.
* @stable ICU 3.8
*/
public static DecimalFormatSymbols getInstance(Locale locale) {
return new DecimalFormatSymbols(locale);
}
/**
* Returns a DecimalFormatSymbols instance for the given locale.
*
* <p><strong>Note:</strong> Unlike <code>java.text.DecimalFormatSymbols#getInstance</code>,
* this method simply returns <code>new com.ibm.icu.text.DecimalFormatSymbols(locale)</code>.
* ICU currently does not support <code>DecimalFormatSymbolsProvider</code>, which was
* introduced in Java 6.
*
* @param locale the locale.
* @return A DecimalFormatSymbols instance.
* @stable ICU 3.8
*/
public static DecimalFormatSymbols getInstance(ULocale locale) {
return new DecimalFormatSymbols(locale);
}
/**
* {@icu} Returns a DecimalFormatSymbols instance for the given locale with digits and symbols
* corresponding to the given {@link NumberingSystem}.
*
* <p>This method behaves equivalently to {@link #getInstance} called with a locale having a
* "numbers=xxxx" keyword specifying the numbering system by name.
*
* <p>In this method, the NumberingSystem argument will be used even if the locale has its own
* "numbers=xxxx" keyword.
*
* @param locale the locale.
* @param ns the numbering system.
* @return A DecimalFormatSymbols instance.
* @stable ICU 60
*/
public static DecimalFormatSymbols forNumberingSystem(Locale locale, NumberingSystem ns) {
return new DecimalFormatSymbols(locale, ns);
}
/**
* {@icu} Returns a DecimalFormatSymbols instance for the given locale with digits and symbols
* corresponding to the given {@link NumberingSystem}.
*
* <p>This method behaves equivalently to {@link #getInstance} called with a locale having a
* "numbers=xxxx" keyword specifying the numbering system by name.
*
* <p>In this method, the NumberingSystem argument will be used even if the locale has its own
* "numbers=xxxx" keyword.
*
* @param locale the locale.
* @param ns the numbering system.
* @return A DecimalFormatSymbols instance.
* @stable ICU 60
*/
public static DecimalFormatSymbols forNumberingSystem(ULocale locale, NumberingSystem ns) {
return new DecimalFormatSymbols(locale, ns);
}
/**
* Returns an array of all locales for which the <code>getInstance</code> methods of this class
* can return localized instances.
*
* <p><strong>Note:</strong> Unlike <code>java.text.DecimalFormatSymbols#getAvailableLocales
* </code>, this method simply returns the array of <code>Locale</code>s available for this
* class. ICU currently does not support <code>DecimalFormatSymbolsProvider</code>, which was
* introduced in Java 6.
*
* @return An array of <code>Locale</code>s for which localized <code>DecimalFormatSymbols
* </code> instances are available.
* @stable ICU 3.8
*/
public static Locale[] getAvailableLocales() {
return ICUResourceBundle.getAvailableLocales();
}
/**
* {@icu} Returns an array of all locales for which the <code>getInstance</code> methods of this
* class can return localized instances.
*
* <p><strong>Note:</strong> Unlike <code>java.text.DecimalFormatSymbols#getAvailableLocales
* </code>, this method simply returns the array of <code>ULocale</code>s available in this
* class. ICU currently does not support <code>DecimalFormatSymbolsProvider</code>, which was
* introduced in Java 6.
*
* @return An array of <code>ULocale</code>s for which localized <code>DecimalFormatSymbols
* </code> instances are available.
* @stable ICU 3.8 (retain)
*/
public static ULocale[] getAvailableULocales() {
return ICUResourceBundle.getAvailableULocales();
}
/**
* Returns the character used for zero. Different for Arabic, etc.
*
* @return the character
* @stable ICU 2.0
* @discouraged ICU 58 use {@link #getDigitStrings()} instead.
*/
public char getZeroDigit() {
return zeroDigit;
}
/**
* Returns the array of characters used as digits, in order from 0 through 9
*
* @return The array
* @stable ICU 4.6
* @see #getDigitStrings()
* @discouraged ICU 58 use {@link #getDigitStrings()} instead.
*/
public char[] getDigits() {
return digits.clone();
}
/**
* Sets the character used for zero.
*
* <p><b>Note:</b> This method propagates digit 1 to digit 9 by incrementing code point one by
* one.
*
* @param zeroDigit the zero character.
* @stable ICU 2.0
* @discouraged ICU 58 use {@link #setDigitStrings(String[])} instead.
*/
public void setZeroDigit(char zeroDigit) {
this.zeroDigit = zeroDigit;
// digitStrings or digits might be referencing a cached copy for
// optimization purpose, so creating a copy before making a modification
digitStrings = digitStrings.clone();
digits = digits.clone();
// Make digitStrings field and digits field in sync
digitStrings[0] = String.valueOf(zeroDigit);
digits[0] = zeroDigit;
// Always propagate to digits 1-9 for JDK and ICU4C consistency.
for (int i = 1; i < 10; i++) {
char d = (char) (zeroDigit + i);
digitStrings[i] = String.valueOf(d);
digits[i] = d;
}
// Update codePointZero: it is simply zeroDigit.
codePointZero = zeroDigit;
}
/**
* {@icu} Returns the array of strings used as digits, in order from 0 through 9
*
* @return The array of ten digit strings
* @see #setDigitStrings(String[])
* @stable ICU 58
*/
public String[] getDigitStrings() {
return digitStrings.clone();
}
/**
* Returns the array of strings used as digits, in order from 0 through 9 Package private method
* - doesn't create a defensively copy.
*
* <p><strong>WARNING:</strong> Mutating the returned array will cause undefined behavior. If
* you need to change the value of the array, use {@link #getDigitStrings} and {@link
* #setDigitStrings} instead.
*
* @return the array of digit strings
* @internal
* @deprecated This API is ICU internal only.
*/
@Deprecated
public String[] getDigitStringsLocal() {
return digitStrings;
}
/**
* If the digit strings array corresponds to a sequence of increasing code points, this method
* returns the code point corresponding to the first entry in the digit strings array. If the
* digit strings array is <em>not</em> a sequence of increasing code points, returns -1.
*
* @internal
* @deprecated This API is ICU internal only.
*/
@Deprecated
public int getCodePointZero() {
return codePointZero;
}
/**
* {@icu} Sets the array of strings used as digits, in order from 0 through 9
*
* <p><b>Note:</b>
*
* <p>When the input array of digit strings contains any strings represented by multiple Java
* chars, then {@link #getDigits()} will return the default digits ('0' - '9') and {@link
* #getZeroDigit()} will return the default zero digit ('0').
*
* @param digitStrings The array of digit strings. The length of the array must be exactly 10.
* @throws NullPointerException if the <code>digitStrings</code> is null.
* @throws IllegalArgumentException if the length of the array is not 10.
* @see #getDigitStrings()
* @stable ICU 58
*/
public void setDigitStrings(String[] digitStrings) {
if (digitStrings == null) {
throw new NullPointerException("The input digit string array is null");
}
if (digitStrings.length != 10) {
throw new IllegalArgumentException("Number of digit strings is not 10");
}
// Scan input array and create char[] representation if possible
// Also update codePointZero if possible
String[] tmpDigitStrings = new String[10];
char[] tmpDigits = new char[10];
int tmpCodePointZero = -1;
for (int i = 0; i < 10; i++) {
String digitStr = digitStrings[i];
if (digitStr == null) {
throw new IllegalArgumentException(
"The input digit string array contains a null element");
}
tmpDigitStrings[i] = digitStr;
int cp, cc;
if (digitStr.length() == 0) {
cp = -1;
cc = 0;
} else {
cp = Character.codePointAt(digitStrings[i], 0);
cc = Character.charCount(cp);
}
if (cc == digitStr.length()) {
// One code point in this digit.
// If it is 1 UTF-16 code unit long, set it in tmpDigits.
if (cc == 1 && tmpDigits != null) {
tmpDigits[i] = (char) cp;
} else {
tmpDigits = null;
}
// Check for validity of tmpCodePointZero.
if (i == 0) {
tmpCodePointZero = cp;
} else if (cp != tmpCodePointZero + i) {
tmpCodePointZero = -1;
}
} else {
// More than one code point in this digit.
// codePointZero and tmpDigits are going to be invalid.
tmpCodePointZero = -1;
tmpDigits = null;
}
}
this.digitStrings = tmpDigitStrings;
this.codePointZero = tmpCodePointZero;
if (tmpDigits == null) {
// fallback to the default digit chars
this.zeroDigit = DEF_DIGIT_CHARS_ARRAY[0];
this.digits = DEF_DIGIT_CHARS_ARRAY;
} else {
this.zeroDigit = tmpDigits[0];
this.digits = tmpDigits;
}
}
/**
* Returns the character used to represent a significant digit in a pattern.
*
* @return the significant digit pattern character
* @stable ICU 3.0
*/
public char getSignificantDigit() {
return sigDigit;
}
/**
* Sets the character used to represent a significant digit in a pattern.
*
* @param sigDigit the significant digit pattern character
* @stable ICU 3.0
*/
public void setSignificantDigit(char sigDigit) {
this.sigDigit = sigDigit;
}
/**
* Returns the character used for grouping separator. Different for French, etc.
*
* @return the thousands character
* @stable ICU 2.0
* @discouraged ICU 58 use {@link #getGroupingSeparatorString()} instead.
*/
public char getGroupingSeparator() {
return groupingSeparator;
}
/**
* Sets the character used for grouping separator. Different for French, etc.
*
* @param groupingSeparator the thousands character
* @stable ICU 2.0
* @see #setGroupingSeparatorString(String)
*/
public void setGroupingSeparator(char groupingSeparator) {
this.groupingSeparator = groupingSeparator;
this.groupingSeparatorString = String.valueOf(groupingSeparator);
}
/**
* {@icu} Returns the string used for grouping separator. Different for French, etc.
*
* @return the grouping separator string
* @see #setGroupingSeparatorString(String)
* @stable ICU 58
*/
public String getGroupingSeparatorString() {
return groupingSeparatorString;
}
/**
* {@icu} Sets the string used for grouping separator.
*
* <p><b>Note:</b> When the input grouping separator String is represented by multiple Java
* chars, then {@link #getGroupingSeparator()} will return the default grouping separator
* character (',').
*
* @param groupingSeparatorString the grouping separator string
* @throws NullPointerException if <code>groupingSeparatorString</code> is null.
* @see #getGroupingSeparatorString()
* @stable ICU 58
*/
public void setGroupingSeparatorString(String groupingSeparatorString) {
if (groupingSeparatorString == null) {
throw new NullPointerException("The input grouping separator is null");
}
this.groupingSeparatorString = groupingSeparatorString;
if (groupingSeparatorString.length() == 1) {
this.groupingSeparator = groupingSeparatorString.charAt(0);
} else {
// Use the default grouping separator character as fallback
this.groupingSeparator = DEF_GROUPING_SEPARATOR;
}
}
/**
* Returns the character used for decimal sign. Different for French, etc.
*
* @return the decimal character
* @stable ICU 2.0
* @discouraged ICU 58 use {@link #getDecimalSeparatorString()} instead.
*/
public char getDecimalSeparator() {
return decimalSeparator;
}
/**
* Sets the character used for decimal sign. Different for French, etc.
*
* @param decimalSeparator the decimal character
* @stable ICU 2.0
*/
public void setDecimalSeparator(char decimalSeparator) {
this.decimalSeparator = decimalSeparator;
this.decimalSeparatorString = String.valueOf(decimalSeparator);
}
/**
* {@icu} Returns the string used for decimal sign.
*
* @return the decimal sign string
* @see #setDecimalSeparatorString(String)
* @stable ICU 58
*/
public String getDecimalSeparatorString() {
return decimalSeparatorString;
}
/**
* {@icu} Sets the string used for decimal sign.
*
* <p><b>Note:</b> When the input decimal separator String is represented by multiple Java
* chars, then {@link #getDecimalSeparator()} will return the default decimal separator
* character ('.').
*
* @param decimalSeparatorString the decimal sign string
* @throws NullPointerException if <code>decimalSeparatorString</code> is null.
* @see #getDecimalSeparatorString()
* @stable ICU 58
*/
public void setDecimalSeparatorString(String decimalSeparatorString) {
if (decimalSeparatorString == null) {
throw new NullPointerException("The input decimal separator is null");
}
this.decimalSeparatorString = decimalSeparatorString;
if (decimalSeparatorString.length() == 1) {
this.decimalSeparator = decimalSeparatorString.charAt(0);
} else {
// Use the default decimal separator character as fallback
this.decimalSeparator = DEF_DECIMAL_SEPARATOR;
}
}
/**
* Returns the character used for mille percent sign. Different for Arabic, etc.
*
* @return the mille percent character
* @stable ICU 2.0
* @discouraged ICU 58 use {@link #getPerMillString()} instead.
*/
public char getPerMill() {
return perMill;
}
/**
* Sets the character used for mille percent sign. Different for Arabic, etc.
*
* @param perMill the mille percent character
* @stable ICU 2.0
*/
public void setPerMill(char perMill) {
this.perMill = perMill;
this.perMillString = String.valueOf(perMill);
}
/**
* {@icu} Returns the string used for permille sign.
*
* @return the permille string
* @see #setPerMillString(String)
* @stable ICU 58
*/
public String getPerMillString() {
return perMillString;
}
/**
* {@icu} Sets the string used for permille sign.
*
* <p><b>Note:</b> When the input permille String is represented by multiple Java chars, then
* {@link #getPerMill()} will return the default permille character ('‰').
*
* @param perMillString the permille string
* @throws NullPointerException if <code>perMillString</code> is null.
* @see #getPerMillString()
* @stable ICU 58
*/
public void setPerMillString(String perMillString) {
if (perMillString == null) {
throw new NullPointerException("The input permille string is null");
}
this.perMillString = perMillString;
if (perMillString.length() == 1) {
this.perMill = perMillString.charAt(0);
} else {
// Use the default permille character as fallback
this.perMill = DEF_PERMILL;
}
}
/**
* Returns the character used for percent sign. Different for Arabic, etc.
*
* @return the percent character
* @stable ICU 2.0
* @discouraged ICU 58 use {@link #getPercentString()} instead.
*/
public char getPercent() {
return percent;
}
/**
* Sets the character used for percent sign. Different for Arabic, etc.
*
* @param percent the percent character
* @stable ICU 2.0
*/
public void setPercent(char percent) {
this.percent = percent;
this.percentString = String.valueOf(percent);
}
/**
* {@icu} Returns the string used for percent sign.
*
* @return the percent string
* @see #setPercentString(String)
* @stable ICU 58
*/
public String getPercentString() {
return percentString;
}
/**
* {@icu} Sets the string used for percent sign.
*
* <p><b>Note:</b> When the input grouping separator String is represented by multiple Java
* chars, then {@link #getPercent()} will return the default percent sign character ('%').
*
* @param percentString the percent string
* @throws NullPointerException if <code>percentString</code> is null.
* @see #getPercentString()
* @stable ICU 58
*/
public void setPercentString(String percentString) {
if (percentString == null) {
throw new NullPointerException("The input percent sign is null");
}
this.percentString = percentString;
if (percentString.length() == 1) {
this.percent = percentString.charAt(0);
} else {
// Use default percent character as fallback
this.percent = DEF_PERCENT;
}
}
/**
* Returns the character used for a digit in a pattern.
*
* @return the digit pattern character
* @stable ICU 2.0
*/
public char getDigit() {
return digit;
}
/**
* Sets the character used for a digit in a pattern.
*
* @param digit the digit pattern character
* @stable ICU 2.0
*/
public void setDigit(char digit) {
this.digit = digit;
}
/**
* Returns the character used to separate positive and negative subpatterns in a pattern.
*
* @return the pattern separator character
* @stable ICU 2.0
*/
public char getPatternSeparator() {
return patternSeparator;
}
/**
* Sets the character used to separate positive and negative subpatterns in a pattern.
*
* @param patternSeparator the pattern separator character
* @stable ICU 2.0
*/
public void setPatternSeparator(char patternSeparator) {
this.patternSeparator = patternSeparator;
}
/**
* Returns the String used to represent infinity. Almost always left unchanged.
*
* @return the Infinity string
* @stable ICU 2.0
*/
// Bug 4194173 [Richard/GCL]
public String getInfinity() {
return infinity;
}
/**
* Sets the String used to represent infinity. Almost always left unchanged.
*
* @param infinity the Infinity String
* @stable ICU 2.0
*/
public void setInfinity(String infinity) {
this.infinity = infinity;
}
/**
* Returns the String used to represent NaN. Almost always left unchanged.
*
* @return the NaN String
* @stable ICU 2.0
*/
// Bug 4194173 [Richard/GCL]
public String getNaN() {
return NaN;
}
/**
* Sets the String used to represent NaN. Almost always left unchanged.
*
* @param NaN the NaN String
* @stable ICU 2.0
*/
public void setNaN(String NaN) {
this.NaN = NaN;
}
/**
* Returns the character used to represent minus sign. If no explicit negative format is
* specified, one is formed by prefixing minusSign to the positive format.
*
* @return the minus sign character
* @stable ICU 2.0
* @discouraged ICU 58 use {@link #getMinusSignString()} instead.
*/
public char getMinusSign() {
return 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.
*
* @param minusSign the minus sign character
* @stable ICU 2.0
*/
public void setMinusSign(char minusSign) {
this.minusSign = minusSign;
this.minusString = String.valueOf(minusSign);
}
/**
* {@icu} Returns the string used to represent minus sign.
*
* @return the minus sign string
* @see #setMinusSignString(String)
* @stable ICU 58
*/
public String getMinusSignString() {
return minusString;
}
/**
* {@icu} Sets the string used to represent minus sign.
*
* <p><b>Note:</b> When the input minus sign String is represented by multiple Java chars, then
* {@link #getMinusSign()} will return the default minus sign character ('-').
*
* @param minusSignString the minus sign string
* @throws NullPointerException if <code>minusSignString</code> is null.
* @see #getGroupingSeparatorString()
* @stable ICU 58
*/
public void setMinusSignString(String minusSignString) {
if (minusSignString == null) {
throw new NullPointerException("The input minus sign is null");
}
this.minusString = minusSignString;
if (minusSignString.length() == 1) {
this.minusSign = minusSignString.charAt(0);
} else {
// Use the default minus sign as fallback
this.minusSign = DEF_MINUS_SIGN;
}
}
/**
* {@icu} Returns the localized plus sign.
*
* @return the plus sign, used in localized patterns and formatted strings
* @see #setPlusSign
* @see #setMinusSign
* @see #getMinusSign
* @stable ICU 2.0
* @discouraged ICU 58 use {@link #getPlusSignString()} instead.
*/
public char getPlusSign() {
return plusSign;
}
/**
* {@icu} Sets the localized plus sign.
*
* @param plus the plus sign, used in localized patterns and formatted strings
* @see #getPlusSign
* @see #setMinusSign
* @see #getMinusSign
* @stable ICU 2.0
*/
public void setPlusSign(char plus) {
this.plusSign = plus;
this.plusString = String.valueOf(plus);
}
/**
* {@icu} Returns the string used to represent plus sign.
*
* @return the plus sign string
* @stable ICU 58
*/
public String getPlusSignString() {
return plusString;
}
/**
* {@icu} Sets the localized plus sign string.
*
* <p><b>Note:</b> When the input plus sign String is represented by multiple Java chars, then
* {@link #getPlusSign()} will return the default plus sign character ('+').
*
* @param plusSignString the plus sign string, used in localized patterns and formatted strings
* @throws NullPointerException if <code>plusSignString</code> is null.
* @see #getPlusSignString()
* @stable ICU 58
*/
public void setPlusSignString(String plusSignString) {
if (plusSignString == null) {
throw new NullPointerException("The input plus sign is null");
}
this.plusString = plusSignString;
if (plusSignString.length() == 1) {
this.plusSign = plusSignString.charAt(0);
} else {
// Use the default plus sign as fallback
this.plusSign = DEF_PLUS_SIGN;
}
}
/**
* @internal ICU 70 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public String getApproximatelySignString() {
return approximatelyString;
}
/**
* @internal ICU 70 technology preview
* @deprecated This API is for technology preview only.
*/
@Deprecated
public void setApproximatelySignString(String approximatelySignString) {
if (approximatelySignString == null) {
throw new NullPointerException("The input plus sign is null");
}
this.approximatelyString = approximatelySignString;
}
/**
* Returns the string denoting the local currency.
*
* @return the local currency String.
* @stable ICU 2.0
*/
public String getCurrencySymbol() {
return currencySymbol;
}
/**
* Sets the string denoting the local currency.
*
* @param currency the local currency String.
* @stable ICU 2.0
*/
public void setCurrencySymbol(String currency) {
currencySymbol = currency;
}
/**
* Returns the international string denoting the local currency.
*
* @return the international string denoting the local currency
* @stable ICU 2.0
*/
public String getInternationalCurrencySymbol() {
return intlCurrencySymbol;
}
/**
* Sets the international string denoting the local currency.
*
* @param currency the international string denoting the local currency.
* @stable ICU 2.0
*/
public void setInternationalCurrencySymbol(String currency) {
intlCurrencySymbol = currency;
}
/**
* Returns the currency symbol, for {@link DecimalFormatSymbols#getCurrency()} API compatibility
* only. ICU clients should use the Currency API directly.
*
* @return the currency used, or null
* @stable ICU 3.4
*/
public Currency getCurrency() {
return currency;
}
/**
* Sets the currency.
*
* <p><strong>Note:</strong> ICU does not use the DecimalFormatSymbols for the currency any
* more. This API is present for API compatibility only.
*
* <p>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.
*
* @param currency the new currency to be used
* @throws NullPointerException if <code>currency</code> is null
* @see #setCurrencySymbol
* @see #setInternationalCurrencySymbol
* @stable ICU 3.4
*/
public void setCurrency(Currency currency) {
if (currency == null) {
throw new NullPointerException();
}
if (currency.equals(this.currency)) {
return;
}
CurrencyDisplayInfo displayInfo = CurrencyData.provider.getInstance(ulocale, true);
setCurrencyOrNull(currency, displayInfo);
}
private void setCurrencyOrNull(Currency currency, CurrencyDisplayInfo displayInfo) {
this.currency = currency;
if (currency == null) {
intlCurrencySymbol = "XXX";
currencySymbol = "\u00A4"; // 'OX' currency symbol
currencyPattern = null;
return;
}
intlCurrencySymbol = currency.getCurrencyCode();
currencySymbol = currency.getSymbol(ulocale);
CurrencyFormatInfo formatInfo = displayInfo.getFormatInfo(currency.getCurrencyCode());
if (formatInfo != null) {
setMonetaryDecimalSeparatorString(formatInfo.monetaryDecimalSeparator);
setMonetaryGroupingSeparatorString(formatInfo.monetaryGroupingSeparator);
currencyPattern = formatInfo.currencyPattern;
}
}
/**
* Returns the monetary decimal separator.
*
* @return the monetary decimal separator character
* @stable ICU 2.0
* @discouraged ICU 58 use {@link #getMonetaryDecimalSeparatorString()} instead.
*/
public char getMonetaryDecimalSeparator() {
return monetarySeparator;
}
/**
* Sets the monetary decimal separator.
*
* @param sep the monetary decimal separator character
* @stable ICU 2.0
*/
public void setMonetaryDecimalSeparator(char sep) {
this.monetarySeparator = sep;
this.monetarySeparatorString = String.valueOf(sep);
}
/**
* {@icu} Returns the monetary decimal separator string.
*
* @return the monetary decimal separator string
* @see #setMonetaryDecimalSeparatorString(String)
* @stable ICU 58
*/
public String getMonetaryDecimalSeparatorString() {
return monetarySeparatorString;
}
/**
* {@icu} Sets the monetary decimal separator string.
*
* <p><b>Note:</b> When the input monetary decimal separator String is represented by multiple
* Java chars, then {@link #getMonetaryDecimalSeparatorString()} will return the default
* monetary decimal separator character ('.').
*
* @param sep the monetary decimal separator string
* @throws NullPointerException if <code>sep</code> is null.
* @see #getMonetaryDecimalSeparatorString()
* @stable ICU 58
*/
public void setMonetaryDecimalSeparatorString(String sep) {
if (sep == null) {
throw new NullPointerException("The input monetary decimal separator is null");
}
this.monetarySeparatorString = sep;
if (sep.length() == 1) {
this.monetarySeparator = sep.charAt(0);
} else {
// Use default decimal separator character as fallback
this.monetarySeparator = DEF_DECIMAL_SEPARATOR;
}
}
/**
* {@icu} Returns the monetary grouping separator.
*
* @return the monetary grouping separator character
* @stable ICU 3.6
* @discouraged ICU 58 use {@link #getMonetaryGroupingSeparatorString()} instead.
*/
public char getMonetaryGroupingSeparator() {
return monetaryGroupingSeparator;
}
/**
* {@icu} Sets the monetary grouping separator.
*
* @param sep the monetary grouping separator character
* @stable ICU 3.6
*/
public void setMonetaryGroupingSeparator(char sep) {
this.monetaryGroupingSeparator = sep;
this.monetaryGroupingSeparatorString = String.valueOf(sep);
}
/**
* {@icu} Returns the monetary grouping separator.
*
* @return the monetary grouping separator string
* @see #setMonetaryGroupingSeparatorString(String)
* @stable ICU 58
*/
public String getMonetaryGroupingSeparatorString() {
return monetaryGroupingSeparatorString;
}
/**
* {@icu} Sets the monetary grouping separator string.
*
* <p><b>Note:</b> When the input grouping separator String is represented by multiple Java
* chars, then {@link #getMonetaryGroupingSeparator()} will return the default monetary grouping
* separator character (',').
*
* @param sep the monetary grouping separator string
* @throws NullPointerException if <code>sep</code> is null.
* @see #getMonetaryGroupingSeparatorString()
* @stable ICU 58
*/
public void setMonetaryGroupingSeparatorString(String sep) {
if (sep == null) {
throw new NullPointerException("The input monetary grouping separator is null");
}
this.monetaryGroupingSeparatorString = sep;
if (sep.length() == 1) {
this.monetaryGroupingSeparator = sep.charAt(0);
} else {
// Use default grouping separator character as fallback
this.monetaryGroupingSeparator = DEF_GROUPING_SEPARATOR;
}
}
/**
* Internal API for NumberFormat
*
* @return String currency pattern string
* @deprecated This API is for ICU internal use only
*/
@Deprecated
public String getCurrencyPattern() {
return currencyPattern;
}
/**
* Returns the multiplication sign
*
* @stable ICU 54
*/
public String getExponentMultiplicationSign() {
return exponentMultiplicationSign;
}
/**
* Sets the multiplication sign
*
* @stable ICU 54
*/
public void setExponentMultiplicationSign(String exponentMultiplicationSign) {
this.exponentMultiplicationSign = exponentMultiplicationSign;
}
/**
* {@icu} Returns the string used to separate the mantissa from the exponent. Examples: "x10^"
* for 1.23x10^4, "E" for 1.23E4.
*
* @return the localized exponent symbol, used in localized patterns and formatted strings
* @see #setExponentSeparator
* @stable ICU 2.0
*/
public String getExponentSeparator() {
return exponentSeparator;
}
/**
* {@icu} Sets the string used to separate the mantissa from the exponent. Examples: "x10^" for
* 1.23x10^4, "E" for 1.23E4.
*
* @param exp the localized exponent symbol, used in localized patterns and formatted strings
* @see #getExponentSeparator
* @stable ICU 2.0
*/
public void setExponentSeparator(String exp) {
exponentSeparator = exp;
}
/**
* {@icu} Returns the character used to pad numbers out to a specified width. This is not the
* pad character itself; rather, it is the special pattern character <em>preceding</em> the pad
* character. In the pattern "*_#,##0", '*' is the pad escape, and '_' is the pad character.
*
* @return the character
* @see #setPadEscape
* @see DecimalFormat#getFormatWidth
* @see DecimalFormat#getPadPosition
* @see DecimalFormat#getPadCharacter
* @stable ICU 2.0
*/
public char getPadEscape() {
return padEscape;
}
/**
* {@icu} Sets the character used to pad numbers out to a specified width. This is not the pad
* character itself; rather, it is the special pattern character <em>preceding</em> the pad
* character. In the pattern "*_#,##0", '*' is the pad escape, and '_' is the pad character.
*
* @see #getPadEscape
* @see DecimalFormat#setFormatWidth
* @see DecimalFormat#setPadPosition
* @see DecimalFormat#setPadCharacter
* @stable ICU 2.0
*/
public void setPadEscape(char c) {
padEscape = c;
}
/**
* {@icu} Indicates the currency match pattern used in {@link #getPatternForCurrencySpacing}.
*
* @stable ICU 4.2
*/
public static final int CURRENCY_SPC_CURRENCY_MATCH = 0;
/**
* {@icu} Indicates the surrounding match pattern used in {@link #getPatternForCurrencySpacing}.
*
* @stable ICU 4.2
*/
public static final int CURRENCY_SPC_SURROUNDING_MATCH = 1;
/**
* {@icu} Indicates the insertion value used in {@link #getPatternForCurrencySpacing}.
*
* @stable ICU 4.4
*/
public static final int CURRENCY_SPC_INSERT = 2;
private String[] currencySpcBeforeSym;
private String[] currencySpcAfterSym;
/**
* {@icu} Returns the desired currency spacing value. Original values come from ICU's CLDR data
* based on the locale provided during construction, and can be null. These values govern what
* and when text is inserted between a currency code/name/symbol and the currency amount when
* formatting money.
*
* <p>For more information, see <a href="http://www.unicode.org/reports/tr35/#Currencies"
* >UTS#35 section 5.10.2</a>.
*
* @param itemType one of CURRENCY_SPC_CURRENCY_MATCH, CURRENCY_SPC_SURROUNDING_MATCH or
* CURRENCY_SPC_INSERT
* @param beforeCurrency true to get the <code>beforeCurrency</code> values, false to get the
* <code>afterCurrency</code> values.
* @return the value, or null.
* @see #setPatternForCurrencySpacing(int, boolean, String)
* @stable ICU 4.2
*/
public String getPatternForCurrencySpacing(int itemType, boolean beforeCurrency) {
if (itemType < CURRENCY_SPC_CURRENCY_MATCH || itemType > CURRENCY_SPC_INSERT) {
throw new IllegalArgumentException("unknown currency spacing: " + itemType);
}
if (beforeCurrency) {
return currencySpcBeforeSym[itemType];
}
return currencySpcAfterSym[itemType];
}
/**
* {@icu} Sets the indicated currency spacing pattern or value. See {@link
* #getPatternForCurrencySpacing} for more information.
*
* <p>Values for currency match and surrounding match must be {@link
* com.ibm.icu.text.UnicodeSet} patterns. Values for insert can be any string.
*
* <p><strong>Note:</strong> ICU4J does not currently use this information.
*
* @param itemType one of CURRENCY_SPC_CURRENCY_MATCH, CURRENCY_SPC_SURROUNDING_MATCH or
* CURRENCY_SPC_INSERT
* @param beforeCurrency true if the pattern is for before the currency symbol. false if the
* pattern is for after it.
* @param pattern string to override current setting; can be null.
* @see #getPatternForCurrencySpacing(int, boolean)
* @stable ICU 4.2
*/
public void setPatternForCurrencySpacing(int itemType, boolean beforeCurrency, String pattern) {
if (itemType < CURRENCY_SPC_CURRENCY_MATCH || itemType > CURRENCY_SPC_INSERT) {
throw new IllegalArgumentException("unknown currency spacing: " + itemType);
}
if (beforeCurrency) {
currencySpcBeforeSym = currencySpcBeforeSym.clone();
currencySpcBeforeSym[itemType] = pattern;
} else {
currencySpcAfterSym = currencySpcAfterSym.clone();
currencySpcAfterSym[itemType] = pattern;
}
}
/**
* Returns the locale for which this object was constructed.
*
* @return the locale for which this object was constructed
* @stable ICU 2.0
*/
public Locale getLocale() {
return requestedLocale;
}
/**
* Returns the locale for which this object was constructed.
*
* @return the locale for which this object was constructed
* @stable ICU 3.2
*/
public ULocale getULocale() {
return ulocale;
}
/**
* {@inheritDoc}
*
* @stable ICU 2.0
*/
@Override
public DecimalFormatSymbols clone() {
try {
return (DecimalFormatSymbols) super.clone();
// other fields are bit-copied
} catch (CloneNotSupportedException e) {
throw new ICUCloneNotSupportedException(e);
}
}
/**
* {@inheritDoc}
*
* @stable ICU 2.0
*/
@Override
public boolean equals(Object obj) {
if (!(obj instanceof DecimalFormatSymbols)) {
return false;
}
if (this == obj) {
return true;
}
DecimalFormatSymbols other = (DecimalFormatSymbols) obj;
for (int i = 0; i <= CURRENCY_SPC_INSERT; i++) {
if (!currencySpcBeforeSym[i].equals(other.currencySpcBeforeSym[i])) {
return false;
}
if (!currencySpcAfterSym[i].equals(other.currencySpcAfterSym[i])) {
return false;
}
}
if (other.digits == null) {
for (int i = 0; i < 10; i++) {
if (digits[i] != other.zeroDigit + i) {
return false;
}
}
} else if (!Arrays.equals(digits, other.digits)) {
return false;
}
return (groupingSeparator == other.groupingSeparator
&& decimalSeparator == other.decimalSeparator
&& percent == other.percent
&& perMill == other.perMill
&& digit == other.digit
&& minusSign == other.minusSign
&& minusString.equals(other.minusString)
&& patternSeparator == other.patternSeparator
&& infinity.equals(other.infinity)
&& NaN.equals(other.NaN)
&& currencySymbol.equals(other.currencySymbol)
&& intlCurrencySymbol.equals(other.intlCurrencySymbol)
&& padEscape == other.padEscape
&& plusSign == other.plusSign
&& plusString.equals(other.plusString)
&& approximatelyString.equals(other.approximatelyString)
&& exponentSeparator.equals(other.exponentSeparator)
&& monetarySeparator == other.monetarySeparator
&& monetaryGroupingSeparator == other.monetaryGroupingSeparator
&& exponentMultiplicationSign.equals(other.exponentMultiplicationSign));
}
/**
* {@inheritDoc}
*
* @stable ICU 2.0
*/
@Override
public int hashCode() {
int result = digits[0];
result = result * 37 + groupingSeparator;
result = result * 37 + decimalSeparator;
return result;
}
/**
* List of field names to be loaded from the data files. The indices of each name into the array
* correspond to the position of that item in the numberElements array.
*/
private static final String[] SYMBOL_KEYS = {
"decimal",
"group",
"percentSign",
"minusSign",
"plusSign",
"exponential",
"perMille",
"infinity",
"nan",
"currencyDecimal",
"currencyGroup",
"superscriptingExponent",
"approximatelySign",
};
/*
* Default digits
*/
private static final String[] DEF_DIGIT_STRINGS_ARRAY = {
"0", "1", "2", "3", "4", "5", "6", "7", "8", "9"
};
private static final char[] DEF_DIGIT_CHARS_ARRAY = {
'0', '1', '2', '3', '4', '5', '6', '7', '8', '9'
};
/*
* Default symbol characters, used for fallbacks.
*/
private static final char DEF_DECIMAL_SEPARATOR = '.';
private static final char DEF_GROUPING_SEPARATOR = ',';
private static final char DEF_PERCENT = '%';
private static final char DEF_MINUS_SIGN = '-';
private static final char DEF_PLUS_SIGN = '+';
private static final char DEF_PERMILL = '\u2030';
/** List of default values for the symbols. */
private static final String[] SYMBOL_DEFAULTS =
new String[] {
String.valueOf(DEF_DECIMAL_SEPARATOR), // decimal
String.valueOf(DEF_GROUPING_SEPARATOR), // group
String.valueOf(DEF_PERCENT), // percentSign
String.valueOf(DEF_MINUS_SIGN), // minusSign
String.valueOf(DEF_PLUS_SIGN), // plusSign
"E", // exponential
String.valueOf(DEF_PERMILL), // perMille
"\u221e", // infinity
"NaN", // NaN
null, // currency decimal
null, // currency group
"\u00D7", // superscripting exponent
"~", // // approximately sign
};
/** Constants for path names in the data bundles. */
private static final String LATIN_NUMBERING_SYSTEM = "latn";
private static final String NUMBER_ELEMENTS = "NumberElements";
private static final String SYMBOLS = "symbols";
/**
* Sink for enumerating all of the decimal format symbols (more specifically, anything under the
* "NumberElements.symbols" tree).
*
* <p>More specific bundles (en_GB) are enumerated before their parents (en_001, en, root): Only
* store a value if it is still missing, that is, it has not been overridden.
*/
private static final class DecFmtDataSink extends UResource.Sink {
private String[] numberElements; // Array where to store the characters (set in constructor)
public DecFmtDataSink(String[] numberElements) {
this.numberElements = numberElements;
}
@Override
public void put(UResource.Key key, UResource.Value value, boolean noFallback) {
UResource.Table symbolsTable = value.getTable();
for (int j = 0; symbolsTable.getKeyAndValue(j, key, value); ++j) {
for (int i = 0; i < SYMBOL_KEYS.length; i++) {
if (key.contentEquals(SYMBOL_KEYS[i])) {
if (numberElements[i] == null) {
numberElements[i] = value.toString();
}
break;
}
}
}
}
}
/** Initializes the symbols from the locale data. */
private void initialize(ULocale locale, NumberingSystem ns) {
this.requestedLocale = locale.toLocale();
this.ulocale = locale;
// TODO: The cache requires a single key, so we just save the NumberingSystem into the
// locale string. NumberingSystem is then decoded again in the loadData() method. It would
// be more efficient if we didn't have to serialize and deserialize the NumberingSystem.
ULocale keyLocale = (ns == null) ? locale : locale.setKeywordValue("numbers", ns.getName());
CacheData data = cachedLocaleData.getInstance(keyLocale, null /* unused */);
setLocale(data.validLocale, data.validLocale);
setDigitStrings(data.digits);
String[] numberElements = data.numberElements;
// Copy data from the numberElements map into instance fields
setDecimalSeparatorString(numberElements[0]);
setGroupingSeparatorString(numberElements[1]);
// #11897: pattern separator is always ';', not from data
patternSeparator = ';';
setPercentString(numberElements[2]);
setMinusSignString(numberElements[3]);
setPlusSignString(numberElements[4]);
setExponentSeparator(numberElements[5]);
setPerMillString(numberElements[6]);
setInfinity(numberElements[7]);
setNaN(numberElements[8]);
setMonetaryDecimalSeparatorString(numberElements[9]);
setMonetaryGroupingSeparatorString(numberElements[10]);
setExponentMultiplicationSign(numberElements[11]);
setApproximatelySignString(numberElements[12]);
digit = '#'; // Localized pattern character no longer in CLDR
padEscape = '*';
sigDigit = '@';
CurrencyDisplayInfo displayInfo = CurrencyData.provider.getInstance(ulocale, true);
initSpacingInfo(displayInfo.getSpacingInfo());
setCurrencyOrNull(Currency.getInstance(ulocale), displayInfo);
}
private static CacheData loadData(ULocale locale) {
String nsName;
// Attempt to set the decimal digits based on the numbering system for the requested locale.
NumberingSystem ns = NumberingSystem.getInstance(locale);
String[] digits = new String[10];
if (ns != null
&& ns.getRadix() == 10
&& !ns.isAlgorithmic()
&& NumberingSystem.isValidDigitString(ns.getDescription())) {
String digitString = ns.getDescription();
for (int i = 0, offset = 0; i < 10; i++) {
int cp = digitString.codePointAt(offset);
int nextOffset = offset + Character.charCount(cp);
digits[i] = digitString.substring(offset, nextOffset);
offset = nextOffset;
}
nsName = ns.getName();
} else {
// Default numbering system
digits = DEF_DIGIT_STRINGS_ARRAY;
nsName = "latn";
}
// Open the resource bundle and get the locale IDs.
// TODO: Is there a better way to get the locale than making an ICUResourceBundle instance?
ICUResourceBundle rb =
(ICUResourceBundle)
UResourceBundle.getBundleInstance(ICUData.ICU_BASE_NAME, locale);
// TODO: Determine actual and valid locale correctly.
ULocale validLocale = rb.getULocale();
String[] numberElements = new String[SYMBOL_KEYS.length];
// Load using a data sink
DecFmtDataSink sink = new DecFmtDataSink(numberElements);
try {
rb.getAllItemsWithFallback(NUMBER_ELEMENTS + "/" + nsName + "/" + SYMBOLS, sink);
} catch (MissingResourceException e) {
// The symbols don't exist for the given nsName and resource bundle.
// Silently ignore and fall back to Latin.
}
// Load the Latin fallback if necessary
boolean hasNull = false;
for (String entry : numberElements) {
if (entry == null) {
hasNull = true;
break;
}
}
if (hasNull && !nsName.equals(LATIN_NUMBERING_SYSTEM)) {
rb.getAllItemsWithFallback(
NUMBER_ELEMENTS + "/" + LATIN_NUMBERING_SYSTEM + "/" + SYMBOLS, sink);
}
// Fill in any remaining missing values
for (int i = 0; i < SYMBOL_KEYS.length; i++) {
if (numberElements[i] == null) {
numberElements[i] = SYMBOL_DEFAULTS[i];
}
}
// If monetary decimal or grouping were not explicitly set, then set them to be the same as
// their non-monetary counterparts.
if (numberElements[9] == null) {
numberElements[9] = numberElements[0];
}
if (numberElements[10] == null) {
numberElements[10] = numberElements[1];
}
return new CacheData(validLocale, digits, numberElements);
}
private void initSpacingInfo(CurrencySpacingInfo spcInfo) {
currencySpcBeforeSym = spcInfo.getBeforeSymbols();
currencySpcAfterSym = spcInfo.getAfterSymbols();
}
/**
* Reads the default serializable fields, then if <code>serialVersionOnStream</code> is less
* than 1, initialize <code>monetarySeparator</code> to be the same as <code>decimalSeparator
* </code> and <code>exponential</code> to be 'E'. Finally, sets serialVersionOnStream back to
* the maximum allowed value so that default serialization will work properly if this object is
* streamed out again.
*/
private void readObject(ObjectInputStream stream) throws IOException, ClassNotFoundException {
// TODO: it looks to me {dlf} that the serialization code was never updated
// to handle the actual/valid ulocale fields.
stream.defaultReadObject();
/// CLOVER:OFF
// we don't have data for these old serialized forms any more
if (serialVersionOnStream < 1) {
// Didn't have monetarySeparator or exponential field;
// use defaults.
monetarySeparator = decimalSeparator;
exponential = 'E';
}
if (serialVersionOnStream < 2) {
padEscape = '*';
plusSign = '+';
exponentSeparator = String.valueOf(exponential);
// Although we read the exponential field on stream to create the
// exponentSeparator, we don't do the reverse, since scientific
// notation isn't supported by the old classes, even though the
// symbol is there.
}
/// CLOVER:ON
if (serialVersionOnStream < 3) {
// Resurrected objects from old streams will have no
// locale. There is no 100% fix for this. A
// 90% fix is to construct a mapping of data back to
// locale, perhaps a hash of all our members. This is
// expensive and doesn't seem worth it.
requestedLocale = Locale.getDefault();
}
if (serialVersionOnStream < 4) {
// use same default behavior as for versions with no Locale
ulocale = ULocale.forLocale(requestedLocale);
}
if (serialVersionOnStream < 5) {
// use the same one for groupingSeparator
monetaryGroupingSeparator = groupingSeparator;
}
if (serialVersionOnStream < 6) {
// Set null to CurrencySpacing related fields.
if (currencySpcBeforeSym == null) {
currencySpcBeforeSym = new String[CURRENCY_SPC_INSERT + 1];
}
if (currencySpcAfterSym == null) {
currencySpcAfterSym = new String[CURRENCY_SPC_INSERT + 1];
}
initSpacingInfo(CurrencyData.CurrencySpacingInfo.DEFAULT);
}
if (serialVersionOnStream < 7) {
// Set minusString,plusString from minusSign,plusSign
if (minusString == null) {
minusString = String.valueOf(minusSign);
}
if (plusString == null) {
plusString = String.valueOf(plusSign);
}
}
if (serialVersionOnStream < 8) {
if (exponentMultiplicationSign == null) {
exponentMultiplicationSign = "\u00D7";
}
}
if (serialVersionOnStream < 9) {
// String version of digits
if (digitStrings == null) {
digitStrings = new String[10];
if (digits != null && digits.length == 10) {
zeroDigit = digits[0];
for (int i = 0; i < 10; i++) {
digitStrings[i] = String.valueOf(digits[i]);
}
} else {
char digit = zeroDigit;
if (digits == null) {
digits = new char[10];
}
for (int i = 0; i < 10; i++) {
digits[i] = digit;
digitStrings[i] = String.valueOf(digit);
digit++;
}
}
}
// String version of symbols
if (decimalSeparatorString == null) {
decimalSeparatorString = String.valueOf(decimalSeparator);
}
if (groupingSeparatorString == null) {
groupingSeparatorString = String.valueOf(groupingSeparator);
}
if (percentString == null) {
percentString = String.valueOf(percent);
}
if (perMillString == null) {
perMillString = String.valueOf(perMill);
}
if (monetarySeparatorString == null) {
monetarySeparatorString = String.valueOf(monetarySeparator);
}
if (monetaryGroupingSeparatorString == null) {
monetaryGroupingSeparatorString = String.valueOf(monetaryGroupingSeparator);
}
}
if (serialVersionOnStream < 10) {
// Approximately sign
approximatelyString = "~"; // fallback
}
serialVersionOnStream = currentSerialVersion;
// recreate
currency = Currency.getInstance(intlCurrencySymbol);
// Refresh digitStrings in order to populate codePointZero
setDigitStrings(digitStrings);
}
/**
* Character used for zero. This remains only for backward compatibility purposes. The digits
* array below is now used to actively store the digits.
*
* @serial
* @see #getZeroDigit
*/
private char zeroDigit;
/** Array of characters used for the digits 0-9 in order. */
private char digits[];
/**
* Array of Strings used for the digits 0-9 in order.
*
* @serial
*/
private String digitStrings[];
/**
* Dealing with code points is faster than dealing with strings when formatting. Because of
* this, we maintain a value containing the zero code point that is used whenever digitStrings
* represents a sequence of ten code points in order.
*
* <p>If the value stored here is positive, it means that the code point stored in this value
* corresponds to the digitStrings array, and codePointZero can be used instead of the
* digitStrings array for the purposes of efficient formatting; if -1, then digitStrings does
* *not* contain a sequence of code points, and it must be used directly.
*
* <p>It is assumed that codePointZero always shadows the value in digitStrings. codePointZero
* should never be set directly; rather, it should be updated only when digitStrings mutates.
* That is, the flow of information is digitStrings -> codePointZero, not the other way.
*/
private transient int codePointZero;
/**
* Character used for thousands separator.
*
* @serial
* @see #getGroupingSeparator
*/
private char groupingSeparator;
/**
* String used for thousands separator.
*
* @serial
*/
private String groupingSeparatorString;
/**
* Character used for decimal sign.
*
* @serial
* @see #getDecimalSeparator
*/
private char decimalSeparator;
/**
* String used for decimal sign.
*
* @serial
*/
private String decimalSeparatorString;
/**
* Character used for mille percent sign.
*
* @serial
* @see #getPerMill
*/
private char perMill;
/**
* String used for mille percent sign.
*
* @serial
*/
private String perMillString;
/**
* Character used for percent sign.
*
* @serial
* @see #getPercent
*/
private char percent;
/**
* String used for percent sign.
*
* @serial
*/
private String percentString;
/**
* Character used for a digit in a pattern.
*
* @serial
* @see #getDigit
*/
private char digit;
/**
* Character used for a significant digit in a pattern.
*
* @serial
* @see #getSignificantDigit
*/
private char sigDigit;
/**
* Character used to separate positive and negative subpatterns in a pattern.
*
* @serial
* @see #getPatternSeparator
*/
private char patternSeparator;
/**
* Character used to represent infinity.
*
* @serial
* @see #getInfinity
*/
private String infinity;
/**
* Character used to represent NaN.
*
* @serial
* @see #getNaN
*/
private String NaN;
/**
* Character used to represent minus sign.
*
* @serial
* @see #getMinusSign
*/
private char minusSign;
/**
* String versions of minus sign.
*
* @serial
* @since ICU 52
*/
private String minusString;
/**
* The character used to indicate a plus sign.
*
* @serial
* @since AlphaWorks
*/
private char plusSign;
/**
* String versions of plus sign.
*
* @serial
* @since ICU 52
*/
private String plusString;
/**
* The string used to indicate an approximately sign.
*
* @serial
* @since ICU 69
*/
private String approximatelyString;
/**
* String denoting the local currency, e.g. "$".
*
* @serial
* @see #getCurrencySymbol
*/
private String currencySymbol;
/**
* International string denoting the local currency, e.g. "USD".
*
* @serial
* @see #getInternationalCurrencySymbol
*/
private String intlCurrencySymbol;
/**
* The decimal separator character used when formatting currency values.
*
* @serial
* @see #getMonetaryDecimalSeparator
*/
private char monetarySeparator; // Field new in JDK 1.1.6
/**
* The decimal separator string used when formatting currency values.
*
* @serial
*/
private String monetarySeparatorString;
/**
* The grouping separator character used when formatting currency values.
*
* @serial
* @see #getMonetaryGroupingSeparator
*/
private char monetaryGroupingSeparator; // Field new in JDK 1.1.6
/**
* The grouping separator string used when formatting currency values.
*
* @serial
*/
private String monetaryGroupingSeparatorString;
/**
* The character used to distinguish the exponent in a number formatted in exponential notation,
* e.g. 'E' for a number such as "1.23E45".
*
* <p>Note that this field has been superseded by <code>exponentSeparator</code>. It is retained
* for backward compatibility.
*
* @serial
*/
private char exponential; // Field new in JDK 1.1.6
/**
* The string used to separate the mantissa from the exponent. Examples: "x10^" for 1.23x10^4,
* "E" for 1.23E4.
*
* <p>Note that this supersedes the <code>exponential</code> field.
*
* @serial
* @since AlphaWorks
*/
private String exponentSeparator;
/**
* The character used to indicate a padding character in a format, e.g., '*' in a pattern such
* as "$*_#,##0.00".
*
* @serial
* @since AlphaWorks
*/
private char padEscape;
/**
* The locale for which this object was constructed. Set to the default locale for objects
* resurrected from old streams.
*
* @since ICU 2.2
*/
private Locale requestedLocale;
/**
* The requested ULocale. We keep the old locale for serialization compatibility.
*
* @since ICU 3.2
*/
private ULocale ulocale;
/**
* Exponent multiplication sign. e.g "x"
*
* @serial
* @since ICU 54
*/
private String exponentMultiplicationSign = null;
// Proclaim JDK 1.1 FCS compatibility
private static final long serialVersionUID = 5772796243397350300L;
// The internal serial version which says which version was written
// - 0 (default) for version up to JDK 1.1.5
// - 1 for version from JDK 1.1.6, which includes two new fields:
// monetarySeparator and exponential.
// - 2 for version from AlphaWorks, which includes 3 new fields:
// padEscape, exponentSeparator, and plusSign.
// - 3 for ICU 2.2, which includes the locale field
// - 4 for ICU 3.2, which includes the ULocale field
// - 5 for ICU 3.6, which includes the monetaryGroupingSeparator field
// - 6 for ICU 4.2, which includes the currencySpc* fields
// - 7 for ICU 52, which includes the minusString and plusString fields
// - 8 for ICU 54, which includes exponentMultiplicationSign field.
// - 9 for ICU 58, which includes a series of String symbol fields.
// - 10 for ICU 69, which includes the approximatelyString field.
private static final int currentSerialVersion = 10;
/**
* Describes the version of <code>DecimalFormatSymbols</code> present on the stream. Possible
* values are:
*
* <ul>
* <li><b>0</b> (or uninitialized): versions prior to JDK 1.1.6.
* <li><b>1</b>: Versions written by JDK 1.1.6 or later, which includes two new fields: <code>
* monetarySeparator</code> and <code>exponential</code>.
* <li><b>2</b>: Version for AlphaWorks. Adds padEscape, exponentSeparator, and plusSign.
* <li><b>3</b>: Version for ICU 2.2, which adds locale.
* <li><b>4</b>: Version for ICU 3.2, which adds ulocale.
* <li><b>5</b>: Version for ICU 3.6, which adds monetaryGroupingSeparator.
* <li><b>6</b>: Version for ICU 4.2, which adds currencySpcBeforeSym and currencySpcAfterSym.
* <li><b>7</b>: Version for ICU 52, which adds minusString and plusString.
* </ul>
*
* When streaming out a <code>DecimalFormatSymbols</code>, the most recent format (corresponding
* to the highest allowable <code>serialVersionOnStream</code>) is always written.
*
* @serial
*/
private int serialVersionOnStream = currentSerialVersion;
/** cache to hold the NumberElements of a Locale. */
private static final CacheBase<ULocale, CacheData, Void> cachedLocaleData =
new SoftCache<ULocale, CacheData, Void>() {
@Override
protected CacheData createInstance(ULocale locale, Void unused) {
return DecimalFormatSymbols.loadData(locale);
}
};
/** */
private String currencyPattern = null;
// -------- BEGIN ULocale boilerplate --------
/**
* {@icu} Returns the locale that was used to create this object, or null. This may may differ
* from the locale requested at the time of this object's creation. For example, if an object is
* created for locale {@code en_US_CALIFORNIA}, the actual data may be drawn from {@code en}
* (the <i>actual</i> locale), and {@code en_US} may be the most specific locale that exists
* (the <i>valid</i> locale).
*
* <p>Note: The <i>actual</i> locale is returned correctly, but the <i>valid</i> locale is not,
* in most cases.
*
* @param type type of information requested, either {@link
* com.ibm.icu.util.ULocale#VALID_LOCALE} or {@link com.ibm.icu.util.ULocale#ACTUAL_LOCALE}.
* @return the information specified by <i>type</i>, or null if this object was not constructed
* from locale data.
* @see com.ibm.icu.util.ULocale
* @see com.ibm.icu.util.ULocale#VALID_LOCALE
* @see com.ibm.icu.util.ULocale#ACTUAL_LOCALE
* @draft ICU 2.8 (retain)
*/
public final ULocale getLocale(ULocale.Type type) {
return type == ULocale.ACTUAL_LOCALE ? this.actualLocale : this.validLocale;
}
/**
* {@icu} Sets information about the locales that were used to create this object. If the object
* was not constructed from locale data, both arguments should be set to null. Otherwise,
* neither should be null. The actual locale must be at the same level or less specific than the
* valid locale. This method is intended for use by factories or other entities that create
* objects of this class.
*
* @param valid the most specific locale containing any resource data, or null
* @param actual the locale containing data used to construct this object, or null
* @see com.ibm.icu.util.ULocale
* @see com.ibm.icu.util.ULocale#VALID_LOCALE
* @see com.ibm.icu.util.ULocale#ACTUAL_LOCALE
*/
final void setLocale(ULocale valid, ULocale actual) {
// Change the following to an assertion later
if ((valid == null) != (actual == null)) {
/// CLOVER:OFF
throw new IllegalArgumentException();
/// CLOVER:ON
}
// Another check we could do is that the actual locale is at
// the same level or less specific than the valid locale.
this.validLocale = valid;
this.actualLocale = actual;
}
/**
* The most specific locale containing any resource data, or null.
*
* @see com.ibm.icu.util.ULocale
*/
private ULocale validLocale;
/**
* The locale containing data used to construct this object, or null.
*
* @see com.ibm.icu.util.ULocale
*/
private ULocale actualLocale;
// not serialized, reconstructed from intlCurrencyCode
private transient Currency currency;
// -------- END ULocale boilerplate --------
private static class CacheData {
final ULocale validLocale;
final String[] digits;
final String[] numberElements;
public CacheData(ULocale loc, String[] digits, String[] numberElements) {
validLocale = loc;
this.digits = digits;
this.numberElements = numberElements;
}
}
}