com.google.gwt.i18n.client

## Annotation Type Messages.AlternateMessage

    @Retention(value=RUNTIME)
     @Target(value=METHOD)
     @Documented
    public static @interface Messages.AlternateMessage

Provides alternate forms of a message, such as are needed when plural forms are used or a placeholder has known gender. The selection of which form to use is based on the value of the arguments marked PluralCount and/or Select.

Example: ``

       @DefaultMessage("You have {0} widgets.")
       @AlternateMessage({"one", "You have one widget.")
       String example(@PluralCount int count);

If multiple `Messages.PluralCount` or `Messages.Select` parameters are supplied, the forms for each, in the order they appear in the parameter list, are supplied separated by a vertical bar ("|"). Example: ``

       @DefaultMessage("You have {0} messages and {1} notifications.")
       @AlternateMessage({
           "=0|=0", "You have no messages or notifications."
           "=0|one", "You have a notification."
           "one|=0", "You have a message."
           "one|one", "You have one message and one notification."
           "other|one", "You have {0} messages and one notification."
           "one|other", "You have one message and {1} notifications."
       })
       String messages(@PluralCount int msgCount,
           @PluralCount int notifyCount);

Note that the number of permutations can grow quickly, and that the default message is used when every `Messages.PluralCount` or `Messages.Select` would use the "other" value.

### Required Element Summary

Required Elements
`java.lang.String[]` `value` An array of pairs of strings containing the strings for different forms.

### Element Detail

#### value

    public abstract java.lang.String[] value

An array of pairs of strings containing the strings for different forms. Each pair is the name of a form followed by the string in the source locale for that form. Each form name is the name of a plural form if `Messages.PluralCount` is used, or the matching value if `Messages.Select` is used. An example for a locale that has "none", "one", and "other" plural forms: `

     @DefaultMessage("{0} widgets")
     @AlternateMessage({"none", "No widgets", "one", "One widget"})

Note that the plural form "other" gets the translation specified in `&#64;DefaultMessage`, as does any `&#64;Select` value not listed. If more than one way of selecting a translation exists, they will be combined, separated with `|`, in the order they are supplied as arguments in the method. For example: `

       @DefaultMessage("{0} gave away their {2} widgets")
       @AlternateMesssage({
         "MALE|other", "{0} gave away his {2} widgets",
         "FEMALE|other", "{0} gave away her {2} widgets",
         "MALE|one", "{0} gave away his widget",
         "FEMALE|one", "{0} gave away her widget",
         "other|one", "{0} gave away their widget",
       })
       String giveAway(String name, @Select Gender gender,
           @PluralCount int count);

``