Lines Matching defs:ARGUMENT
66 * Some of the API methods work only with argument numbers and throw an exception
69 * <p>An argument might not specify any format type. In this case,
74 * <p>An argument might specify a "simple" type for which the specified
77 * <p>An argument might have a "complex" type with nested MessageFormat sub-patterns.
78 * During formatting, one of these sub-messages is selected according to the argument value
82 * a top-level argument, overriding the default formatting and parsing behavior
83 * for that argument.
85 * a typeless argument in the pattern string
88 * <p>When formatting, MessageFormat takes a collection of argument values
90 * The argument values may be passed as an array
94 * <p>Each argument is matched with one of the input values by array index or map key
97 * A numbered pattern argument is matched with a map key that contains that number
104 * message = messageText (argument messageText)*
105 * argument = noneArg | simpleArg | complexArg
146 * <p>The <code>choice</code> argument type is deprecated.
296 * <p>For messages that include plural forms, you can use a plural argument:
347 * @param nameValuePairs (argument name, argument value) pairs
398 * Parses the pattern and caches Format objects for simple argument types.
423 * Parses the pattern and caches Format objects for simple argument types.
522 * correspond to the argument indices used in the previously set
529 * If an argument index is used for more than one format element
531 * for all such format elements. If an argument index is not used
534 * than needed, then only the formats for argument indices less
549 "that use alphanumeric argument names.");
562 * methods. The keys in <code>newFormats</code> are the argument
566 * Only argument names from the pattern string are considered.
568 * to an argument name are ignored. Similarly, if there is no
569 * format in newFormats for an argument name, the formatter
570 * for that argument remains unchanged.
574 * represent argument indices, e.g. "0", "1", "2" etc.
624 * previously set pattern string that use the given argument
626 * The argument index is part of the format element definition and
631 * If the argument index is used for more than one format element
633 * format elements. If the argument index is not used for any format
637 * argument names. Otherwise an IllegalArgumentException is thrown.
639 * @param argumentIndex the argument index for which to use the new format
648 "that use alphanumeric argument names.");
659 * previously set pattern string that use the given argument
662 * If the argument name is used for more than one format element
664 * format elements. If the argument name is not used for any format
669 * an argument index, e.g. "0", "1", "2"... etc. If it does not name
672 * @param argumentName the name of the argument to change
697 * method, which accesses format elements based on the argument
722 * correspond to the argument indices used in the previously set
729 * If an argument index is used for more than one format element
731 * format element is returned in the array. If an argument index
736 * argument names. Otherwise an IllegalArgumentException is thrown.
746 "that use alphanumeric argument names.");
774 * argument names. Otherwise an IllegalArgumentException is thrown.
789 * {@icu} Returns the top-level argument names. For more details, see
791 * @return a Set of argument names
803 * {@icu} Returns the first top-level format associated with the given argument name.
805 * @param argumentName The name of the desired argument.
832 * <code>arguments</code> element at the format element's argument index
834 * argument is <i>unavailable</i> if <code>arguments</code> is
836 * an argument is unavailable no substitution is performed.
854 * <td><code>customFormat.format(argument)</code>
858 * <td><code>NumberFormat.getInstance(getLocale()).format(argument)</code>
863 * DateFormat.SHORT, getLocale()).format(argument)</code>
867 * <td><code>argument</code>
871 * <td><code>argument.toString()</code>
879 * <code>Field.ARGUMENT</code>, the location of the first formatted
891 * expected by the corresponding argument or custom Format object.
910 * argument name.
912 * A numbered pattern argument is matched with a map key that contains that number
915 * An argument is <i>unavailable</i> if <code>arguments</code> is
916 * <code>null</code> or does not have a value corresponding to an argument
917 * name in the pattern. When an argument is unavailable no substitution
926 * expected by the corresponding argument or custom Format object.
948 * expected by the corresponding argument or custom Format object.
965 * expected by the corresponding argument or custom Format object.
1004 * @throws IllegalArgumentException if an argument in
1035 * argument in the <code>arguments</code> array. The keys of these attributes are of
1038 * array of the argument from which the text was generated.
1043 * This allows you to not only find where an argument is placed in the
1051 * expected by the corresponding argument or custom Format object.
1077 * <li>If the format of an argument loses information, such as
1086 * <li>If a single argument is parsed more than once in the string,
1104 "that use named argument.");
1136 argument.
1294 "Parsing of plural/select/selectordinal argument is not supported.");
1313 * argument to values. The method may not use the entire text of the given string.
1434 if (this.getName().equals(ARGUMENT.getName())) {
1435 return ARGUMENT;
1443 * from an argument passed into <code>formatToCharacterIterator</code>.
1446 * argument from which the text was generated.
1450 public static final Field ARGUMENT = new Field("message argument field");
1481 * the message. The format is inferred from the argument.
1513 * @param pluralNumber null except when formatting a plural argument sub-message
1602 // Do not use the formatted (number-offset) string for a named argument
1615 // any argument which got reset to null via setFormat() or its siblings.
1736 * as soon as it finds an argument, or it reaches the end of the string.
1764 if (fp != null && Field.ARGUMENT.equals(fp.getFieldAttribute())) {
1776 * @param partIndex the index of the first ChoiceFormat argument style part.
1777 * @param number a number to be mapped to one of the ChoiceFormat argument's intervals
1887 * @param partIndex the index of the first PluralFormat argument style part.
1971 /** argument number - plural offset */
1978 /** formatted argument number - plural offset */
2015 assert context.number.doubleValue() == number; // argument number minus the offset
2042 * @throws IllegalArgumentException if an argument in the
2051 "that use alphanumeric argument names.");
2494 * Defaults the field to Field.ARGUMENT.
2497 init(Field.ARGUMENT, fieldValue, startIndex, limitIndex);
