src/java.base/share/classes/java/text/spi/NumberFormatProvider.java
changeset 58242 94bb65cb37d3
parent 52869 c5c0db0b7c2f
child 58288 48e480e56aad
equal deleted inserted replaced
58241:33de7752835c 58242:94bb65cb37d3
     1 /*
     1 /*
     2  * Copyright (c) 2005, 2018, Oracle and/or its affiliates. All rights reserved.
     2  * Copyright (c) 2005, 2019, Oracle and/or its affiliates. All rights reserved.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     4  *
     4  *
     5  * This code is free software; you can redistribute it and/or modify it
     5  * This code is free software; you can redistribute it and/or modify it
     6  * under the terms of the GNU General Public License version 2 only, as
     6  * under the terms of the GNU General Public License version 2 only, as
     7  * published by the Free Software Foundation.  Oracle designates this
     7  * published by the Free Software Foundation.  Oracle designates this
    48     /**
    48     /**
    49      * Returns a new <code>NumberFormat</code> instance which formats
    49      * Returns a new <code>NumberFormat</code> instance which formats
    50      * monetary values for the specified locale.
    50      * monetary values for the specified locale.
    51      *
    51      *
    52      * @param locale the desired locale.
    52      * @param locale the desired locale.
    53      * @exception NullPointerException if <code>locale</code> is null
    53      * @throws    NullPointerException if <code>locale</code> is null
    54      * @exception IllegalArgumentException if <code>locale</code> isn't
    54      * @throws    IllegalArgumentException if <code>locale</code> isn't
    55      *     one of the locales returned from
    55      *     one of the locales returned from
    56      *     {@link java.util.spi.LocaleServiceProvider#getAvailableLocales()
    56      *     {@link java.util.spi.LocaleServiceProvider#getAvailableLocales()
    57      *     getAvailableLocales()}.
    57      *     getAvailableLocales()}.
    58      * @return a currency formatter
    58      * @return a currency formatter
    59      * @see java.text.NumberFormat#getCurrencyInstance(java.util.Locale)
    59      * @see java.text.NumberFormat#getCurrencyInstance(java.util.Locale)
    69      * for formatting, and to parse only the integer part of
    69      * for formatting, and to parse only the integer part of
    70      * an input string (see {@link
    70      * an input string (see {@link
    71      * java.text.NumberFormat#isParseIntegerOnly isParseIntegerOnly}).
    71      * java.text.NumberFormat#isParseIntegerOnly isParseIntegerOnly}).
    72      *
    72      *
    73      * @param locale the desired locale
    73      * @param locale the desired locale
    74      * @exception NullPointerException if <code>locale</code> is null
    74      * @throws    NullPointerException if <code>locale</code> is null
    75      * @exception IllegalArgumentException if <code>locale</code> isn't
    75      * @throws    IllegalArgumentException if <code>locale</code> isn't
    76      *     one of the locales returned from
    76      *     one of the locales returned from
    77      *     {@link java.util.spi.LocaleServiceProvider#getAvailableLocales()
    77      *     {@link java.util.spi.LocaleServiceProvider#getAvailableLocales()
    78      *     getAvailableLocales()}.
    78      *     getAvailableLocales()}.
    79      * @return a number format for integer values
    79      * @return a number format for integer values
    80      * @see java.text.NumberFormat#getIntegerInstance(java.util.Locale)
    80      * @see java.text.NumberFormat#getIntegerInstance(java.util.Locale)
    84     /**
    84     /**
    85      * Returns a new general-purpose <code>NumberFormat</code> instance for
    85      * Returns a new general-purpose <code>NumberFormat</code> instance for
    86      * the specified locale.
    86      * the specified locale.
    87      *
    87      *
    88      * @param locale the desired locale
    88      * @param locale the desired locale
    89      * @exception NullPointerException if <code>locale</code> is null
    89      * @throws    NullPointerException if <code>locale</code> is null
    90      * @exception IllegalArgumentException if <code>locale</code> isn't
    90      * @throws    IllegalArgumentException if <code>locale</code> isn't
    91      *     one of the locales returned from
    91      *     one of the locales returned from
    92      *     {@link java.util.spi.LocaleServiceProvider#getAvailableLocales()
    92      *     {@link java.util.spi.LocaleServiceProvider#getAvailableLocales()
    93      *     getAvailableLocales()}.
    93      *     getAvailableLocales()}.
    94      * @return a general-purpose number formatter
    94      * @return a general-purpose number formatter
    95      * @see java.text.NumberFormat#getNumberInstance(java.util.Locale)
    95      * @see java.text.NumberFormat#getNumberInstance(java.util.Locale)
    99     /**
    99     /**
   100      * Returns a new <code>NumberFormat</code> instance which formats
   100      * Returns a new <code>NumberFormat</code> instance which formats
   101      * percentage values for the specified locale.
   101      * percentage values for the specified locale.
   102      *
   102      *
   103      * @param locale the desired locale
   103      * @param locale the desired locale
   104      * @exception NullPointerException if <code>locale</code> is null
   104      * @throws    NullPointerException if <code>locale</code> is null
   105      * @exception IllegalArgumentException if <code>locale</code> isn't
   105      * @throws    IllegalArgumentException if <code>locale</code> isn't
   106      *     one of the locales returned from
   106      *     one of the locales returned from
   107      *     {@link java.util.spi.LocaleServiceProvider#getAvailableLocales()
   107      *     {@link java.util.spi.LocaleServiceProvider#getAvailableLocales()
   108      *     getAvailableLocales()}.
   108      *     getAvailableLocales()}.
   109      * @return a percent formatter
   109      * @return a percent formatter
   110      * @see java.text.NumberFormat#getPercentInstance(java.util.Locale)
   110      * @see java.text.NumberFormat#getPercentInstance(java.util.Locale)