jdk-sandbox: comparison src/java.base/share/classes/java/text/MessageFormat.java

equal deleted inserted replaced

-:33de7752835c
+:94bb65cb37d3
 * creates a list of subformats for the format elements contained in it.
 * Patterns and their interpretation are specified in the
 * <a href="#patterns">class description</a>.
 *
 * @param pattern the pattern for this message format
-* @exception IllegalArgumentException if the pattern is invalid
+* @throws    IllegalArgumentException if the pattern is invalid
-* @exception NullPointerException if {@code pattern} is
+* @throws    NullPointerException if {@code pattern} is
 *            {@code null}
 */
 public MessageFormat(String pattern) {
 this.locale = Locale.getDefault(Locale.Category.FORMAT);
 applyPattern(pattern);
 * Patterns and their interpretation are specified in the
 * <a href="#patterns">class description</a>.
 *
 * @param pattern the pattern for this message format
 * @param locale the locale for this message format
-* @exception IllegalArgumentException if the pattern is invalid
+* @throws    IllegalArgumentException if the pattern is invalid
-* @exception NullPointerException if {@code pattern} is
+* @throws    NullPointerException if {@code pattern} is
 *            {@code null}
 * @since 1.4
 */
 public MessageFormat(String pattern, Locale locale) {
 this.locale = locale;
 * for the format elements contained in it.
 * Patterns and their interpretation are specified in the
 * <a href="#patterns">class description</a>.
 *
 * @param pattern the pattern for this message format
-* @exception IllegalArgumentException if the pattern is invalid
+* @throws    IllegalArgumentException if the pattern is invalid
-* @exception NullPointerException if {@code pattern} is
+* @throws    NullPointerException if {@code pattern} is
 *            {@code null}
 */
 @SuppressWarnings("fallthrough") // fallthrough in switch is expected, suppress it
 public void applyPattern(String pattern) {
 StringBuilder[] segments = new StringBuilder[4];
 * corresponding new format is ignored. If fewer formats are provided
 * than needed, then only the formats for argument indices less
 * than <code>newFormats.length</code> are replaced.
 *
 * @param newFormats the new formats to use
-* @exception NullPointerException if <code>newFormats</code> is null
+* @throws    NullPointerException if <code>newFormats</code> is null
 * @since 1.4
 */
 public void setFormatsByArgumentIndex(Format[] newFormats) {
 for (int i = 0; i <= maxOffset; i++) {
 int j = argumentNumbers[i];
 * order of elements in the <code>arguments</code> array passed to
 * the <code>format</code> methods or the result array returned by
 * the <code>parse</code> methods.
 *
 * @param newFormats the new formats to use
-* @exception NullPointerException if <code>newFormats</code> is null
+* @throws    NullPointerException if <code>newFormats</code> is null
 */
 public void setFormats(Format[] newFormats) {
 int runsToCopy = newFormats.length;
 if (runsToCopy > maxOffset + 1) {
 runsToCopy = maxOffset + 1;
 * method, which accesses format elements based on the argument
 * index they specify.
 *
 * @param formatElementIndex the index of a format element within the pattern
 * @param newFormat the format to use for the specified format element
-* @exception ArrayIndexOutOfBoundsException if {@code formatElementIndex} is equal to or
+* @throws    ArrayIndexOutOfBoundsException if {@code formatElementIndex} is equal to or
 *            larger than the number of format elements in the pattern string
 */
 public void setFormat(int formatElementIndex, Format newFormat) {
 if (formatElementIndex > maxOffset) {
 * @param result where text is appended.
 * @param pos keeps track on the position of the first replaced argument
 in the output string.
 * @return the string buffer passed in as {@code result}, with formatted
 * text appended
-* @exception IllegalArgumentException if an argument in the
+* @throws    IllegalArgumentException if an argument in the
 *            <code>arguments</code> array is not of the type
 *            expected by the format element(s) that use it.
-* @exception NullPointerException if {@code result} is {@code null}
+* @throws    NullPointerException if {@code result} is {@code null}
 */
 public final StringBuffer format(Object[] arguments, StringBuffer result,
 FieldPosition pos)
 {
 return subformat(arguments, result, pos, null);
 * </blockquote>
 *
 * @param pattern   the pattern string
 * @param arguments object(s) to format
 * @return the formatted string
-* @exception IllegalArgumentException if the pattern is invalid,
+* @throws    IllegalArgumentException if the pattern is invalid,
 *            or if an argument in the <code>arguments</code> array
 *            is not of the type expected by the format element(s)
 *            that use it.
-* @exception NullPointerException if {@code pattern} is {@code null}
+* @throws    NullPointerException if {@code pattern} is {@code null}
 */
 public static String format(String pattern, Object ... arguments) {
 MessageFormat temp = new MessageFormat(pattern);
 return temp.format(arguments);
 }
 *
 * @param arguments an array of objects to be formatted and substituted.
 * @param result where text is appended.
 * @param pos keeps track on the position of the first replaced argument
 *            in the output string.
-* @exception IllegalArgumentException if an argument in the
+* @throws    IllegalArgumentException if an argument in the
 *            <code>arguments</code> array is not of the type
 *            expected by the format element(s) that use it.
-* @exception NullPointerException if {@code result} is {@code null}
+* @throws    NullPointerException if {@code result} is {@code null}
 */
 public final StringBuffer format(Object arguments, StringBuffer result,
 FieldPosition pos)
 {
 return subformat((Object[]) arguments, result, pos, null);
 * This allows you to not only find where an argument is placed in the
 * resulting String, but also which fields it contains in turn.
 *
 * @param arguments an array of objects to be formatted and substituted.
 * @return AttributedCharacterIterator describing the formatted value.
-* @exception NullPointerException if <code>arguments</code> is null.
+* @throws    NullPointerException if <code>arguments</code> is null.
-* @exception IllegalArgumentException if an argument in the
+* @throws    IllegalArgumentException if an argument in the
 *            <code>arguments</code> array is not of the type
 *            expected by the format element(s) that use it.
 * @since 1.4
 */
 public AttributedCharacterIterator formatToCharacterIterator(Object arguments) {
 * If the source is null, return an empty array.
 *
 * @param source the string to parse
 * @param pos    the parse position
 * @return an array of parsed objects
-* @exception NullPointerException if {@code pos} is {@code null}
+* @throws    NullPointerException if {@code pos} is {@code null}
 *            for a non-null {@code source} string.
 */
 public Object[] parse(String source, ParsePosition pos) {
 if (source == null) {
 Object[] empty = {};
 * See the {@link #parse(String, ParsePosition)} method for more information
 * on message parsing.
 *
 * @param source A <code>String</code> whose beginning should be parsed.
 * @return An <code>Object</code> array parsed from the string.
-* @exception ParseException if the beginning of the specified string
+* @throws    ParseException if the beginning of the specified string
 *            cannot be parsed.
 */
 public Object[] parse(String source) throws ParseException {
 ParsePosition pos  = new ParsePosition(0);
 Object[] result = parse(source, pos);
 * subformats as necessary. If {@code characterIterators} is {@code null}
 * and {@code fp} is {@code non-null} and identifies
 * {@code Field.ARGUMENT} as the field attribute, the location of
 * the first replaced argument will be set in it.
 *
-* @exception IllegalArgumentException if an argument in the
+* @throws    IllegalArgumentException if an argument in the
 *            <code>arguments</code> array is not of the type
 *            expected by the format element(s) that use it.
 */
 private StringBuffer subformat(Object[] arguments, StringBuffer result,
 FieldPosition fp, List<AttributedCharacterIterator> characterIterators) {

changeset 58242	94bb65cb37d3
parent 57956	e0b8b019d2f5
child 58288	48e480e56aad