Java tutorial
/* * Copyright (c) 1996, 2019, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ /* * (C) Copyright Taligent, Inc. 1996, 1997 - All Rights Reserved * (C) Copyright IBM Corp. 1996 - 1998 - All Rights Reserved * * The original version of this source code and documentation is copyrighted * and owned by Taligent, Inc., a wholly-owned subsidiary of IBM. These * materials are provided under terms of a License Agreement between Taligent * and Sun. This technology is protected by multiple US and International * patents. This notice and attribution to Taligent may not be removed. * Taligent is a registered trademark of Taligent, Inc. * */ package java.text; import java.io.InvalidObjectException; import java.io.IOException; import java.io.ObjectInputStream; import java.io.Serializable; import java.text.spi.DecimalFormatSymbolsProvider; import java.util.Currency; import java.util.Locale; import java.util.Objects; import sun.util.locale.provider.CalendarDataUtility; import sun.util.locale.provider.LocaleProviderAdapter; import sun.util.locale.provider.LocaleServiceProviderPool; import sun.util.locale.provider.ResourceBundleBasedAdapter; /** * This class represents the set of symbols (such as the decimal separator, * the grouping separator, and so on) needed by {@code DecimalFormat} * to format numbers. {@code DecimalFormat} creates for itself an instance of * {@code DecimalFormatSymbols} from its locale data. If you need to change any * of these symbols, you can get the {@code DecimalFormatSymbols} object from * your {@code DecimalFormat} and modify it. * * <p>If the locale contains "rg" (region override) * <a href="../util/Locale.html#def_locale_extension">Unicode extension</a>, * the symbols are overridden for the designated region. * * @see java.util.Locale * @see DecimalFormat * @author Mark Davis * @author Alan Liu * @since 1.1 */ public class DecimalFormatSymbols implements Cloneable, Serializable { /** * Create a DecimalFormatSymbols object for the default * {@link java.util.Locale.Category#FORMAT FORMAT} locale. * This constructor can only construct instances for the locales * supported by the Java runtime environment, not for those * supported by installed * {@link java.text.spi.DecimalFormatSymbolsProvider DecimalFormatSymbolsProvider} * implementations. For full locale coverage, use the * {@link #getInstance(Locale) getInstance} method. * <p>This is equivalent to calling * {@link #DecimalFormatSymbols(Locale) * DecimalFormatSymbols(Locale.getDefault(Locale.Category.FORMAT))}. * @see java.util.Locale#getDefault(java.util.Locale.Category) * @see java.util.Locale.Category#FORMAT */ public DecimalFormatSymbols() { initialize(Locale.getDefault(Locale.Category.FORMAT)); } /** * 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 * {@link java.text.spi.DecimalFormatSymbolsProvider DecimalFormatSymbolsProvider} * implementations. For full locale coverage, use the * {@link #getInstance(Locale) getInstance} method. * If the specified locale contains the {@link java.util.Locale#UNICODE_LOCALE_EXTENSION} * for the numbering system, the instance is initialized with the specified numbering * system if the JRE implementation supports it. For example, * <pre> * NumberFormat.getNumberInstance(Locale.forLanguageTag("th-TH-u-nu-thai")) * </pre> * This may return a {@code NumberFormat} instance with the Thai numbering system, * instead of the Latin numbering system. * * @param locale the desired locale * @exception NullPointerException if {@code locale} is null */ public DecimalFormatSymbols(Locale locale) { initialize(locale); } /** * Returns an array of all locales for which the * {@code 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 * {@link java.text.spi.DecimalFormatSymbolsProvider DecimalFormatSymbolsProvider} * implementations. It must contain at least a {@code Locale} * instance equal to {@link java.util.Locale#US Locale.US}. * * @return an array of locales for which localized * {@code DecimalFormatSymbols} instances are available. * @since 1.6 */ public static Locale[] getAvailableLocales() { LocaleServiceProviderPool pool = LocaleServiceProviderPool.getPool(DecimalFormatSymbolsProvider.class); return pool.getAvailableLocales(); } /** * Gets the {@code DecimalFormatSymbols} instance for the default * locale. This method provides access to {@code DecimalFormatSymbols} * instances for locales supported by the Java runtime itself as well * as for those supported by installed * {@link java.text.spi.DecimalFormatSymbolsProvider * DecimalFormatSymbolsProvider} implementations. * <p>This is equivalent to calling * {@link #getInstance(Locale) * getInstance(Locale.getDefault(Locale.Category.FORMAT))}. * @see java.util.Locale#getDefault(java.util.Locale.Category) * @see java.util.Locale.Category#FORMAT * @return a {@code DecimalFormatSymbols} instance. * @since 1.6 */ public static final DecimalFormatSymbols getInstance() { return getInstance(Locale.getDefault(Locale.Category.FORMAT)); } /** * Gets the {@code DecimalFormatSymbols} instance for the specified * locale. This method provides access to {@code DecimalFormatSymbols} * instances for locales supported by the Java runtime itself as well * as for those supported by installed * {@link java.text.spi.DecimalFormatSymbolsProvider * DecimalFormatSymbolsProvider} implementations. * If the specified locale contains the {@link java.util.Locale#UNICODE_LOCALE_EXTENSION} * for the numbering system, the instance is initialized with the specified numbering * system if the JRE implementation supports it. For example, * <pre> * NumberFormat.getNumberInstance(Locale.forLanguageTag("th-TH-u-nu-thai")) * </pre> * This may return a {@code NumberFormat} instance with the Thai numbering system, * instead of the Latin numbering system. * * @param locale the desired locale. * @return a {@code DecimalFormatSymbols} instance. * @exception NullPointerException if {@code locale} is null * @since 1.6 */ public static final DecimalFormatSymbols getInstance(Locale locale) { LocaleProviderAdapter adapter; adapter = LocaleProviderAdapter.getAdapter(DecimalFormatSymbolsProvider.class, locale); DecimalFormatSymbolsProvider provider = adapter.getDecimalFormatSymbolsProvider(); DecimalFormatSymbols dfsyms = provider.getInstance(locale); if (dfsyms == null) { provider = LocaleProviderAdapter.forJRE().getDecimalFormatSymbolsProvider(); dfsyms = provider.getInstance(locale); } return dfsyms; } /** * Gets the character used for zero. Different for Arabic, etc. * * @return the character used for zero */ public char getZeroDigit() { return zeroDigit; } /** * Sets the character used for zero. Different for Arabic, etc. * * @param zeroDigit the character used for zero */ public void setZeroDigit(char zeroDigit) { this.zeroDigit = zeroDigit; } /** * Gets the character used for thousands separator. Different for French, etc. * * @return the grouping separator */ public char getGroupingSeparator() { return groupingSeparator; } /** * Sets the character used for thousands separator. Different for French, etc. * * @param groupingSeparator the grouping separator */ public void setGroupingSeparator(char groupingSeparator) { this.groupingSeparator = groupingSeparator; } /** * Gets the character used for decimal sign. Different for French, etc. * * @return the character used for decimal sign */ public char getDecimalSeparator() { return decimalSeparator; } /** * Sets the character used for decimal sign. Different for French, etc. * * @param decimalSeparator the character used for decimal sign */ public void setDecimalSeparator(char decimalSeparator) { this.decimalSeparator = decimalSeparator; } /** * Gets the character used for per mille sign. Different for Arabic, etc. * * @return the character used for per mille sign */ public char getPerMill() { return perMill; } /** * Sets the character used for per mille sign. Different for Arabic, etc. * * @param perMill the character used for per mille sign */ public void setPerMill(char perMill) { this.perMill = perMill; this.perMillText = Character.toString(perMill); } /** * Gets the string used for per mille sign. Different for Arabic, etc. * * @return the string used for per mille sign * @since 13 */ String getPerMillText() { return perMillText; } /** * Sets the string used for per mille sign. Different for Arabic, etc. * * Setting the {@code perMillText} affects the return value of * {@link #getPerMill()}, in which the first non-format character of * {@code perMillText} is returned. * * @param perMillText the string used for per mille sign * @throws NullPointerException if {@code perMillText} is null * @throws IllegalArgumentException if {@code perMillText} is an empty string * @see #getPerMill() * @see #getPerMillText() * @since 13 */ void setPerMillText(String perMillText) { Objects.requireNonNull(perMillText); if (perMillText.isEmpty()) { throw new IllegalArgumentException("Empty argument string"); } this.perMillText = perMillText; this.perMill = findNonFormatChar(perMillText, '\u2030'); } /** * Gets the character used for percent sign. Different for Arabic, etc. * * @return the character used for percent sign */ public char getPercent() { return percent; } /** * Sets the character used for percent sign. Different for Arabic, etc. * * @param percent the character used for percent sign */ public void setPercent(char percent) { this.percent = percent; this.percentText = Character.toString(percent); } /** * Gets the string used for percent sign. Different for Arabic, etc. * * @return the string used for percent sign * @since 13 */ String getPercentText() { return percentText; } /** * Sets the string used for percent sign. Different for Arabic, etc. * * Setting the {@code percentText} affects the return value of * {@link #getPercent()}, in which the first non-format character of * {@code percentText} is returned. * * @param percentText the string used for percent sign * @throws NullPointerException if {@code percentText} is null * @throws IllegalArgumentException if {@code percentText} is an empty string * @see #getPercent() * @see #getPercentText() * @since 13 */ void setPercentText(String percentText) { Objects.requireNonNull(percentText); if (percentText.isEmpty()) { throw new IllegalArgumentException("Empty argument string"); } this.percentText = percentText; this.percent = findNonFormatChar(percentText, '%'); } /** * Gets the character used for a digit in a pattern. * * @return the character used for a digit in a pattern */ public char getDigit() { return digit; } /** * Sets the character used for a digit in a pattern. * * @param digit the character used for a digit in a pattern */ public void setDigit(char digit) { this.digit = digit; } /** * Gets the character used to separate positive and negative subpatterns * in a pattern. * * @return the pattern separator */ public char getPatternSeparator() { return patternSeparator; } /** * Sets the character used to separate positive and negative subpatterns * in a pattern. * * @param patternSeparator the pattern separator */ public void setPatternSeparator(char patternSeparator) { this.patternSeparator = patternSeparator; } /** * Gets the string used to represent infinity. Almost always left * unchanged. * * @return the string representing infinity */ public String getInfinity() { return infinity; } /** * Sets the string used to represent infinity. Almost always left * unchanged. * * @param infinity the string representing infinity */ public void setInfinity(String infinity) { this.infinity = infinity; } /** * Gets the string used to represent "not a number". Almost always left * unchanged. * * @return the string representing "not a number" */ public String getNaN() { return NaN; } /** * Sets the string used to represent "not a number". Almost always left * unchanged. * * @param NaN the string representing "not a number" */ public void setNaN(String NaN) { this.NaN = NaN; } /** * 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. * * @return the character representing minus sign */ 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 character representing minus sign */ public void setMinusSign(char minusSign) { this.minusSign = minusSign; this.minusSignText = Character.toString(minusSign); } /** * Gets the string used to represent minus sign. If no explicit * negative format is specified, one is formed by prefixing * minusSignText to the positive format. * * @return the string representing minus sign * @since 13 */ String getMinusSignText() { return minusSignText; } /** * Sets the string used to represent minus sign. If no explicit * negative format is specified, one is formed by prefixing * minusSignText to the positive format. * * Setting the {@code minusSignText} affects the return value of * {@link #getMinusSign()}, in which the first non-format character of * {@code minusSignText} is returned. * * @param minusSignText the character representing minus sign * @throws NullPointerException if {@code minusSignText} is null * @throws IllegalArgumentException if {@code minusSignText} is an * empty string * @see #getMinusSign() * @see #getMinusSignText() * @since 13 */ void setMinusSignText(String minusSignText) { Objects.requireNonNull(minusSignText); if (minusSignText.isEmpty()) { throw new IllegalArgumentException("Empty argument string"); } this.minusSignText = minusSignText; this.minusSign = findNonFormatChar(minusSignText, '-'); } /** * Returns the currency symbol for the currency of these * DecimalFormatSymbols in their locale. * * @return the currency symbol * @since 1.2 */ public String getCurrencySymbol() { initializeCurrency(locale); return currencySymbol; } /** * Sets the currency symbol for the currency of these * DecimalFormatSymbols in their locale. * * @param currency the currency symbol * @since 1.2 */ public void setCurrencySymbol(String currency) { initializeCurrency(locale); currencySymbol = currency; } /** * Returns the ISO 4217 currency code of the currency of these * DecimalFormatSymbols. * * @return the currency code * @since 1.2 */ public String getInternationalCurrencySymbol() { initializeCurrency(locale); return intlCurrencySymbol; } /** * Sets the ISO 4217 currency code of the currency of these * DecimalFormatSymbols. * If the currency code is valid (as defined by * {@link java.util.Currency#getInstance(java.lang.String) 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. * * @param currencyCode the currency code * @see #setCurrency * @see #setCurrencySymbol * @since 1.2 */ public void setInternationalCurrencySymbol(String currencyCode) { initializeCurrency(locale); intlCurrencySymbol = currencyCode; currency = null; if (currencyCode != null) { try { currency = Currency.getInstance(currencyCode); currencySymbol = currency.getSymbol(); } catch (IllegalArgumentException e) { } } } /** * 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. * * @return the currency used, or null * @since 1.4 */ public Currency getCurrency() { initializeCurrency(locale); return 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. * * @param currency the new currency to be used * @exception NullPointerException if {@code currency} is null * @since 1.4 * @see #setCurrencySymbol * @see #setInternationalCurrencySymbol */ public void setCurrency(Currency currency) { if (currency == null) { throw new NullPointerException(); } initializeCurrency(locale); this.currency = currency; intlCurrencySymbol = currency.getCurrencyCode(); currencySymbol = currency.getSymbol(locale); } /** * Returns the monetary decimal separator. * * @return the monetary decimal separator * @since 1.2 */ public char getMonetaryDecimalSeparator() { return monetarySeparator; } /** * Sets the monetary decimal separator. * * @param sep the monetary decimal separator * @since 1.2 */ public void setMonetaryDecimalSeparator(char sep) { monetarySeparator = sep; } //------------------------------------------------------------ // BEGIN Package Private methods ... to be made public later //------------------------------------------------------------ /** * Returns the character used to separate the mantissa from the exponent. */ char getExponentialSymbol() { return exponential; } /** * Returns the string used to separate the mantissa from the exponent. * Examples: "x10^" for 1.23x10^4, "E" for 1.23E4. * * @return the exponent separator string * @see #setExponentSeparator(java.lang.String) * @since 1.6 */ public String getExponentSeparator() { return exponentialSeparator; } /** * Sets the character used to separate the mantissa from the exponent. */ void setExponentialSymbol(char exp) { exponential = exp; } /** * Sets the string used to separate the mantissa from the exponent. * Examples: "x10^" for 1.23x10^4, "E" for 1.23E4. * * @param exp the exponent separator string * @exception NullPointerException if {@code exp} is null * @see #getExponentSeparator() * @since 1.6 */ public void setExponentSeparator(String exp) { if (exp == null) { throw new NullPointerException(); } exponentialSeparator = exp; } //------------------------------------------------------------ // END Package Private methods ... to be made public later //------------------------------------------------------------ /** * Standard override. */ @Override public Object clone() { try { return (DecimalFormatSymbols) super.clone(); // other fields are bit-copied } catch (CloneNotSupportedException e) { throw new InternalError(e); } } /** * Override equals. */ @Override public boolean equals(Object obj) { if (obj == null) return false; if (this == obj) return true; if (getClass() != obj.getClass()) return false; DecimalFormatSymbols other = (DecimalFormatSymbols) obj; return (zeroDigit == other.zeroDigit && groupingSeparator == other.groupingSeparator && decimalSeparator == other.decimalSeparator && percent == other.percent && percentText.equals(other.percentText) && perMill == other.perMill && perMillText.equals(other.perMillText) && digit == other.digit && minusSign == other.minusSign && minusSignText.equals(other.minusSignText) && patternSeparator == other.patternSeparator && infinity.equals(other.infinity) && NaN.equals(other.NaN) && getCurrencySymbol().equals(other.getCurrencySymbol()) && // possible currency init occurs here intlCurrencySymbol.equals(other.intlCurrencySymbol) && currency == other.currency && monetarySeparator == other.monetarySeparator && exponentialSeparator.equals(other.exponentialSeparator) && locale.equals(other.locale)); } /** * Override hashCode. */ @Override public int hashCode() { int result = zeroDigit; result = result * 37 + groupingSeparator; result = result * 37 + decimalSeparator; return result; } /** * Initializes the symbols from the FormatData resource bundle. */ private void initialize(Locale locale) { this.locale = locale; // check for region override Locale override = locale.getUnicodeLocaleType("nu") == null ? CalendarDataUtility.findRegionOverride(locale) : locale; // get resource bundle data LocaleProviderAdapter adapter = LocaleProviderAdapter.getAdapter(DecimalFormatSymbolsProvider.class, override); // Avoid potential recursions if (!(adapter instanceof ResourceBundleBasedAdapter)) { adapter = LocaleProviderAdapter.getResourceBundleBased(); } Object[] data = adapter.getLocaleResources(override).getDecimalFormatSymbolsData(); String[] numberElements = (String[]) data[0]; decimalSeparator = numberElements[0].charAt(0); groupingSeparator = numberElements[1].charAt(0); patternSeparator = numberElements[2].charAt(0); percentText = numberElements[3]; percent = findNonFormatChar(percentText, '%'); zeroDigit = numberElements[4].charAt(0); //different for Arabic,etc. digit = numberElements[5].charAt(0); minusSignText = numberElements[6]; minusSign = findNonFormatChar(minusSignText, '-'); exponential = numberElements[7].charAt(0); exponentialSeparator = numberElements[7]; //string representation new since 1.6 perMillText = numberElements[8]; perMill = findNonFormatChar(perMillText, '\u2030'); infinity = numberElements[9]; NaN = numberElements[10]; // maybe filled with previously cached values, or null. intlCurrencySymbol = (String) data[1]; currencySymbol = (String) data[2]; // Currently the monetary decimal separator is the same as the // standard decimal separator for all locales that we support. // If that changes, add a new entry to NumberElements. monetarySeparator = decimalSeparator; } /** * Obtains non-format single character from String */ private char findNonFormatChar(String src, char defChar) { return (char) src.chars().filter(c -> Character.getType(c) != Character.FORMAT).findFirst().orElse(defChar); } /** * Lazy initialization for currency related fields */ private void initializeCurrency(Locale locale) { if (currencyInitialized) { return; } // Try to obtain the currency used in the locale's country. // Check for empty country string separately because it's a valid // country ID for Locale (and used for the C locale), but not a valid // ISO 3166 country code, and exceptions are expensive. if (!locale.getCountry().isEmpty()) { try { currency = Currency.getInstance(locale); } catch (IllegalArgumentException e) { // use default values below for compatibility } } if (currency != null) { // get resource bundle data LocaleProviderAdapter adapter = LocaleProviderAdapter.getAdapter(DecimalFormatSymbolsProvider.class, locale); // Avoid potential recursions if (!(adapter instanceof ResourceBundleBasedAdapter)) { adapter = LocaleProviderAdapter.getResourceBundleBased(); } Object[] data = adapter.getLocaleResources(locale).getDecimalFormatSymbolsData(); intlCurrencySymbol = currency.getCurrencyCode(); if (data[1] != null && data[1] == intlCurrencySymbol) { currencySymbol = (String) data[2]; } else { currencySymbol = currency.getSymbol(locale); data[1] = intlCurrencySymbol; data[2] = currencySymbol; } } else { // default values intlCurrencySymbol = "XXX"; try { currency = Currency.getInstance(intlCurrencySymbol); } catch (IllegalArgumentException e) { } currencySymbol = "\u00A4"; } currencyInitialized = true; } /** * Reads the default serializable fields, provides default values for objects * in older serial versions, and initializes non-serializable fields. * If {@code serialVersionOnStream} * is less than 1, initializes {@code monetarySeparator} to be * the same as {@code decimalSeparator} and {@code exponential} * to be 'E'. * If {@code serialVersionOnStream} is less than 2, * initializes {@code locale}to the root locale, and initializes * If {@code serialVersionOnStream} is less than 3, it initializes * {@code exponentialSeparator} using {@code exponential}. * If {@code serialVersionOnStream} is less than 4, it initializes * {@code perMillText}, {@code percentText}, and * {@code minusSignText} using {@code perMill}, {@code percent}, and * {@code minusSign} respectively. * Sets {@code serialVersionOnStream} back to the maximum allowed value so that * default serialization will work properly if this object is streamed out again. * Initializes the currency from the intlCurrencySymbol field. * * @throws InvalidObjectException if {@code char} and {@code String} * representations of either percent, per mille, and/or minus sign disagree. * @since 1.1.6 */ private void readObject(ObjectInputStream stream) throws IOException, ClassNotFoundException { stream.defaultReadObject(); if (serialVersionOnStream < 1) { // Didn't have monetarySeparator or exponential field; // use defaults. monetarySeparator = decimalSeparator; exponential = 'E'; } if (serialVersionOnStream < 2) { // didn't have locale; use root locale locale = Locale.ROOT; } if (serialVersionOnStream < 3) { // didn't have exponentialSeparator. Create one using exponential exponentialSeparator = Character.toString(exponential); } if (serialVersionOnStream < 4) { // didn't have perMillText, percentText, and minusSignText. // Create one using corresponding char variations. perMillText = Character.toString(perMill); percentText = Character.toString(percent); minusSignText = Character.toString(minusSign); } else { // Check whether char and text fields agree if (findNonFormatChar(perMillText, '\uFFFF') != perMill || findNonFormatChar(percentText, '\uFFFF') != percent || findNonFormatChar(minusSignText, '\uFFFF') != minusSign) { throw new InvalidObjectException("'char' and 'String' representations of either percent, " + "per mille, and/or minus sign disagree."); } } serialVersionOnStream = currentSerialVersion; if (intlCurrencySymbol != null) { try { currency = Currency.getInstance(intlCurrencySymbol); } catch (IllegalArgumentException e) { } currencyInitialized = true; } } /** * Character used for zero. * * @serial * @see #getZeroDigit */ private char zeroDigit; /** * Character used for thousands separator. * * @serial * @see #getGroupingSeparator */ private char groupingSeparator; /** * Character used for decimal sign. * * @serial * @see #getDecimalSeparator */ private char decimalSeparator; /** * Character used for per mille sign. * * @serial * @see #getPerMill */ private char perMill; /** * Character used for percent sign. * @serial * @see #getPercent */ private char percent; /** * Character used for a digit in a pattern. * * @serial * @see #getDigit */ private char digit; /** * Character used to separate positive and negative subpatterns * in a pattern. * * @serial * @see #getPatternSeparator */ private char patternSeparator; /** * String used to represent infinity. * @serial * @see #getInfinity */ private String infinity; /** * String used to represent "not a number". * @serial * @see #getNaN */ private String NaN; /** * Character used to represent minus sign. * @serial * @see #getMinusSign */ private char minusSign; /** * String denoting the local currency, e.g. "$". * @serial * @see #getCurrencySymbol */ private String currencySymbol; /** * ISO 4217 currency code denoting the local currency, e.g. "USD". * @serial * @see #getInternationalCurrencySymbol */ private String intlCurrencySymbol; /** * The decimal separator used when formatting currency values. * @serial * @since 1.1.6 * @see #getMonetaryDecimalSeparator */ private char monetarySeparator; // Field new in JDK 1.1.6 /** * 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 the public API provides no way to set this field, * even though it is supported by the implementation and the stream format. * The intent is that this will be added to the API in the future. * * @serial * @since 1.1.6 */ 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> * If both {@code exponential} and {@code exponentialSeparator} * exist, this {@code exponentialSeparator} has the precedence. * * @serial * @since 1.6 */ private String exponentialSeparator; // Field new in JDK 1.6 /** * The locale of these currency format symbols. * * @serial * @since 1.4 */ private Locale locale; /** * String representation of per mille sign, which may include * formatting characters, such as BiDi control characters. * The first non-format character of this string is the same as * {@code perMill}. * * @serial * @since 13 */ private String perMillText; /** * String representation of percent sign, which may include * formatting characters, such as BiDi control characters. * The first non-format character of this string is the same as * {@code percent}. * * @serial * @since 13 */ private String percentText; /** * String representation of minus sign, which may include * formatting characters, such as BiDi control characters. * The first non-format character of this string is the same as * {@code minusSign}. * * @serial * @since 13 */ private String minusSignText; // currency; only the ISO code is serialized. private transient Currency currency; private transient volatile boolean currencyInitialized; // Proclaim JDK 1.1 FCS compatibility 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 J2SE 1.4, which includes locale field. // - 3 for version from J2SE 1.6, which includes exponentialSeparator field. // - 4 for version from Java SE 13, which includes perMillText, percentText, // and minusSignText field. private static final int currentSerialVersion = 4; /** * Describes the version of {@code DecimalFormatSymbols} 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 include * two new fields: {@code monetarySeparator} and {@code exponential}. * <li><b>2</b>: Versions written by J2SE 1.4 or later, which include a * new {@code locale} field. * <li><b>3</b>: Versions written by J2SE 1.6 or later, which include a * new {@code exponentialSeparator} field. * <li><b>4</b>: Versions written by Java SE 13 or later, which include * new {@code perMillText}, {@code percentText}, and * {@code minusSignText} field. * </ul> * When streaming out a {@code DecimalFormatSymbols}, the most recent format * (corresponding to the highest allowable {@code serialVersionOnStream}) * is always written. * * @serial * @since 1.1.6 */ private int serialVersionOnStream = currentSerialVersion; }