organicmaps/icu
13
Fork 0
mirror of https://github.com/unicode-org/icu.git synced 2025-04-06 14:05:32 +00:00
Code Issues 1 Projects Releases Wiki Activity Actions 8

ICU-22325 BRS#19 ICU4J 74 Status and Change Report

Browse source 
Change FormattedNumber.getNounClass to @stable ICU 72
This commit is contained in:
Craig 2023-09-20 17:22:10 -07:00 • committed by Craig Cornelius
parent f14b24a845
commit 263db44a3a
4 changed files with 283 additions and 169 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

276
icu4j/APIChangeReport.html
View file

@ -4,119 +4,135 @@
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- © 2023 and later: Unicode, Inc. and others. -->
<!-- License & terms of use: http://www.unicode.org/copyright.html -->
<title>ICU4J API Comparison: ICU4J 72 with ICU4J 73</title>
<title>ICU4J API Comparison: ICU4J 73 with ICU4J 74</title>
</head>
<body>
<h1>ICU4J API Comparison: ICU4J 72 with ICU4J 73</h1>
<h1>ICU4J API Comparison: ICU4J 73 with ICU4J 74</h1>
<hr/>
<h2>Removed from ICU4J 72</h2>
<h2>Removed from ICU4J 73</h2>
<p>(no API removed)</p>
<hr/>
<h2>Deprecated or Obsoleted in ICU4J 73</h2>
<h2>Deprecated or Obsoleted in ICU4J 74</h2>
<h3>Package com.ibm.icu.text</h3>
<ul>
UnicodeSet
RuleBasedNumberFormat
<ul>
<li><span style='color:gray'>(deprecated)</span> public static final int CASE</li>
<li><span style='color:gray'>(deprecated)</span> public static final int DURATION</li>
</ul>
</ul>
<hr/>
<h2>Changed in ICU4J 73 (old, new)</h2>
<h2>Changed in ICU4J 74 (old, new)</h2>
<p>(no API changed)</p>
<hr/>
<h2>Promoted to stable in ICU4J 73</h2>
<h2>Promoted to stable in ICU4J 74</h2>
<h3>Package com.ibm.icu.number</h3>
<ul>
FormattedNumber
<ul>
<li><span style='color:green'>(stable)</span> public DisplayOptions.NounClass <i>getNounClass</i>()</li>
</ul>
NumberFormatterSettings
<ul>
<li><span style='color:green'>(stable)</span> public T extends NumberFormatterSettings&lt;?&gt; <i>displayOptions</i>(DisplayOptions)</li>
</ul>
</ul>
<h3>Package com.ibm.icu.text</h3>
<ul>
DateTimePatternGenerator
<li><span style='color:green'>(stable)</span> public final class <i>DisplayOptions</i></li>
<li><span style='color:green'>(stable)</span> public static class <i>DisplayOptions.Builder</i></li>
<li><span style='color:green'>(stable)</span> public static enum <i>DisplayOptions.Capitalization</i></li>
<li><span style='color:green'>(stable)</span> public static enum <i>DisplayOptions.DisplayLength</i></li>
<li><span style='color:green'>(stable)</span> public static enum <i>DisplayOptions.GrammaticalCase</i></li>
<li><span style='color:green'>(stable)</span> public static enum <i>DisplayOptions.NameStyle</i></li>
<li><span style='color:green'>(stable)</span> public static enum <i>DisplayOptions.NounClass</i></li>
<li><span style='color:green'>(stable)</span> public static enum <i>DisplayOptions.PluralCategory</i></li>
<li><span style='color:green'>(stable)</span> public static enum <i>DisplayOptions.SubstituteHandling</i></li>
DisplayOptions.Capitalization
<ul>
<li><span style='color:green'>(stable)</span> public java.lang.String <i>getDateTimeFormat</i>(int)</li>
<li><span style='color:green'>(stable)</span> public void <i>setDateTimeFormat</i>(int, java.lang.String)</li>
<li><span style='color:green'>(stable)</span> public static final java.util.List&lt;DisplayOptions.Capitalization&gt; VALUES</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.Capitalization BEGINNING_OF_SENTENCE</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.Capitalization MIDDLE_OF_SENTENCE</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.Capitalization STANDALONE</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.Capitalization UI_LIST_OR_MENU</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.Capitalization UNDEFINED</li>
</ul>
NumberFormat.Field
DisplayOptions.DisplayLength
<ul>
<li><span style='color:green'>(stable)</span> public static final NumberFormat.Field APPROXIMATELY_SIGN</li>
<li><span style='color:green'>(stable)</span> public static final java.util.List&lt;DisplayOptions.DisplayLength&gt; VALUES</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.DisplayLength LENGTH_FULL</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.DisplayLength LENGTH_SHORT</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.DisplayLength UNDEFINED</li>
</ul>
DisplayOptions.GrammaticalCase
<ul>
<li><span style='color:green'>(stable)</span> public static final java.util.List&lt;DisplayOptions.GrammaticalCase&gt; VALUES</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.GrammaticalCase <i>fromIdentifier</i>(java.lang.String)</li>
<li><span style='color:green'>(stable)</span> public final java.lang.String <i>getIdentifier</i>()</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.GrammaticalCase ABLATIVE</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.GrammaticalCase ACCUSATIVE</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.GrammaticalCase COMITATIVE</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.GrammaticalCase DATIVE</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.GrammaticalCase ERGATIVE</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.GrammaticalCase GENITIVE</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.GrammaticalCase INSTRUMENTAL</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.GrammaticalCase LOCATIVE</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.GrammaticalCase LOCATIVE_COPULATIVE</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.GrammaticalCase NOMINATIVE</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.GrammaticalCase OBLIQUE</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.GrammaticalCase PREPOSITIONAL</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.GrammaticalCase SOCIATIVE</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.GrammaticalCase UNDEFINED</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.GrammaticalCase VOCATIVE</li>
</ul>
<hr/>
<h2>Added in ICU4J 73</h2>
<h3>Package com.ibm.icu.text</h3>
DisplayOptions.NameStyle
<ul>
<li><span style='color:orange'>(draft)</span> public interface <i>PersonName</i></li>
<li><span style='color:orange'>(draft)</span> public class <i>PersonNameFormatter</i></li>
<li><span style='color:orange'>(draft)</span> public static class <i>PersonNameFormatter.Builder</i></li>
<li><span style='color:orange'>(draft)</span> public class <i>SimplePersonName</i></li>
<li><span style='color:orange'>(draft)</span> public static class <i>SimplePersonName.Builder</i></li>
<li><span style='color:orange'>(draft)</span> public static enum <i>PersonName.FieldModifier</i></li>
<li><span style='color:orange'>(draft)</span> public static enum <i>PersonName.NameField</i></li>
<li><span style='color:orange'>(draft)</span> public static enum <i>PersonName.PreferredOrder</i></li>
<li><span style='color:orange'>(draft)</span> public static enum <i>PersonNameFormatter.DisplayOrder</i></li>
<li><span style='color:orange'>(draft)</span> public static enum <i>PersonNameFormatter.Formality</i></li>
<li><span style='color:orange'>(draft)</span> public static enum <i>PersonNameFormatter.Length</i></li>
<li><span style='color:orange'>(draft)</span> public static enum <i>PersonNameFormatter.Usage</i></li>
PersonName.FieldModifier
<ul>
<li><span style='color:orange'>(draft)</span> public static PersonName.FieldModifier <i>forString</i>(java.lang.String)</li>
<li><span style='color:orange'>(draft)</span> public java.lang.String <i>toString</i>()</li>
<li><span style='color:orange'>(draft)</span> public static final PersonName.FieldModifier ALL_CAPS</li>
<li><span style='color:orange'>(draft)</span> public static final PersonName.FieldModifier CORE</li>
<li><span style='color:orange'>(draft)</span> public static final PersonName.FieldModifier INFORMAL</li>
<li><span style='color:orange'>(draft)</span> public static final PersonName.FieldModifier INITIAL</li>
<li><span style='color:orange'>(draft)</span> public static final PersonName.FieldModifier INITIAL_CAP</li>
<li><span style='color:orange'>(draft)</span> public static final PersonName.FieldModifier MONOGRAM</li>
<li><span style='color:orange'>(draft)</span> public static final PersonName.FieldModifier PREFIX</li>
<li><span style='color:green'>(stable)</span> public static final java.util.List&lt;DisplayOptions.NameStyle&gt; VALUES</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.NameStyle DIALECT_NAMES</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.NameStyle STANDARD_NAMES</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.NameStyle UNDEFINED</li>
</ul>
PersonName.NameField
DisplayOptions.NounClass
<ul>
<li><span style='color:orange'>(draft)</span> public java.lang.String <i>toString</i>()</li>
<li><span style='color:orange'>(draft)</span> public static final PersonName.NameField CREDENTIALS</li>
<li><span style='color:orange'>(draft)</span> public static final PersonName.NameField GENERATION</li>
<li><span style='color:orange'>(draft)</span> public static final PersonName.NameField GIVEN</li>
<li><span style='color:orange'>(draft)</span> public static final PersonName.NameField GIVEN2</li>
<li><span style='color:orange'>(draft)</span> public static final PersonName.NameField SURNAME</li>
<li><span style='color:orange'>(draft)</span> public static final PersonName.NameField SURNAME2</li>
<li><span style='color:orange'>(draft)</span> public static final PersonName.NameField TITLE</li>
<li><span style='color:green'>(stable)</span> public static final java.util.List&lt;DisplayOptions.NounClass&gt; VALUES</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.NounClass <i>fromIdentifier</i>(java.lang.String)</li>
<li><span style='color:green'>(stable)</span> public final java.lang.String <i>getIdentifier</i>()</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.NounClass ANIMATE</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.NounClass COMMON</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.NounClass FEMININE</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.NounClass INANIMATE</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.NounClass MASCULINE</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.NounClass NEUTER</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.NounClass OTHER</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.NounClass PERSONAL</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.NounClass UNDEFINED</li>
</ul>
PersonName.PreferredOrder
DisplayOptions.PluralCategory
<ul>
<li><span style='color:orange'>(draft)</span> public static final PersonName.PreferredOrder DEFAULT</li>
<li><span style='color:orange'>(draft)</span> public static final PersonName.PreferredOrder GIVEN_FIRST</li>
<li><span style='color:orange'>(draft)</span> public static final PersonName.PreferredOrder SURNAME_FIRST</li>
<li><span style='color:green'>(stable)</span> public static final java.util.List&lt;DisplayOptions.PluralCategory&gt; VALUES</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.PluralCategory <i>fromIdentifier</i>(java.lang.String)</li>
<li><span style='color:green'>(stable)</span> public final java.lang.String <i>getIdentifier</i>()</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.PluralCategory FEW</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.PluralCategory MANY</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.PluralCategory ONE</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.PluralCategory OTHER</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.PluralCategory TWO</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.PluralCategory UNDEFINED</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.PluralCategory ZERO</li>
</ul>
PersonNameFormatter.DisplayOrder
DisplayOptions.SubstituteHandling
<ul>
<li><span style='color:orange'>(draft)</span> public static final PersonNameFormatter.DisplayOrder DEFAULT</li>
<li><span style='color:orange'>(draft)</span> public static final PersonNameFormatter.DisplayOrder SORTING</li>
</ul>
PersonNameFormatter.Formality
<ul>
<li><span style='color:orange'>(draft)</span> public static final PersonNameFormatter.Formality FORMAL</li>
<li><span style='color:orange'>(draft)</span> public static final PersonNameFormatter.Formality INFORMAL</li>
</ul>
PersonNameFormatter.Length
<ul>
<li><span style='color:orange'>(draft)</span> public static final PersonNameFormatter.Length LONG</li>
<li><span style='color:orange'>(draft)</span> public static final PersonNameFormatter.Length MEDIUM</li>
<li><span style='color:orange'>(draft)</span> public static final PersonNameFormatter.Length SHORT</li>
</ul>
PersonNameFormatter.Usage
<ul>
<li><span style='color:orange'>(draft)</span> public static final PersonNameFormatter.Usage ADDRESSING</li>
<li><span style='color:orange'>(draft)</span> public static final PersonNameFormatter.Usage MONOGRAM</li>
<li><span style='color:orange'>(draft)</span> public static final PersonNameFormatter.Usage REFERRING</li>
</ul>
UnicodeSet
<ul>
<li><span style='color:orange'>(draft)</span> public static final int SIMPLE_CASE_INSENSITIVE</li>
<li><span style='color:green'>(stable)</span> public static final java.util.List&lt;DisplayOptions.SubstituteHandling&gt; VALUES</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.SubstituteHandling NO_SUBSTITUTE</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.SubstituteHandling SUBSTITUTE</li>
<li><span style='color:green'>(stable)</span> public static final DisplayOptions.SubstituteHandling UNDEFINED</li>
</ul>
</ul>
@ -124,11 +140,109 @@ UnicodeSet
<ul>
MeasureUnit
<ul>
<li><span style='color:orange'>(draft)</span> public static final MeasureUnit BEAUFORT</li>
<li><span style='color:green'>(stable)</span> public static final MeasureUnit QUARTER</li>
<li><span style='color:green'>(stable)</span> public static final MeasureUnit TONNE</li>
</ul>
</ul>
<hr/>
<h2>Added in ICU4J 74</h2>
<h3>Package com.ibm.icu.lang</h3>
<ul>
UCharacter.LineBreak
<ul>
<li><span style='color:green'>(stable)</span> public static final int AKSARA</li>
<li><span style='color:green'>(stable)</span> public static final int AKSARA_PREBASE</li>
<li><span style='color:green'>(stable)</span> public static final int AKSARA_START</li>
<li><span style='color:green'>(stable)</span> public static final int VIRAMA</li>
<li><span style='color:green'>(stable)</span> public static final int VIRAMA_FINAL</li>
</ul>
UCharacter.UnicodeBlock
<ul>
<li><span style='color:green'>(stable)</span> public static final UCharacter.UnicodeBlock CJK_UNIFIED_IDEOGRAPHS_EXTENSION_I</li>
<li><span style='color:green'>(stable)</span> public static final int CJK_UNIFIED_IDEOGRAPHS_EXTENSION_I_ID</li>
</ul>
UProperty
<ul>
<li><span style='color:orange'>(draft)</span> public static final int IDS_UNARY_OPERATOR</li>
<li><span style='color:orange'>(draft)</span> public static final int ID_COMPAT_MATH_CONTINUE</li>
<li><span style='color:orange'>(draft)</span> public static final int ID_COMPAT_MATH_START</li>
</ul>
</ul>
<h3>Package com.ibm.icu.text</h3>
<ul>
Normalizer2
<ul>
<li><span style='color:orange'>(draft)</span> public static Normalizer2 <i>getNFKCSimpleCasefoldInstance</i>()</li>
</ul>
PersonName.FieldModifier
<ul>
<li><span style='color:orange'>(draft)</span> public static final PersonName.FieldModifier GENITIVE</li>
<li><span style='color:orange'>(draft)</span> public static final PersonName.FieldModifier VOCATIVE</li>
</ul>
PersonNameFormatter.DisplayOrder
<ul>
<li><span style='color:orange'>(draft)</span> public static final PersonNameFormatter.DisplayOrder FORCE_GIVEN_FIRST</li>
<li><span style='color:orange'>(draft)</span> public static final PersonNameFormatter.DisplayOrder FORCE_SURNAME_FIRST</li>
</ul>
PersonNameFormatter.Formality
<ul>
<li><span style='color:orange'>(draft)</span> public static final PersonNameFormatter.Formality DEFAULT</li>
</ul>
PersonNameFormatter.Length
<ul>
<li><span style='color:orange'>(draft)</span> public static final PersonNameFormatter.Length DEFAULT</li>
</ul>
SpoofChecker
<ul>
<li><span style='color:orange'>(draft)</span> public int <i>areConfusable</i>(int, java.lang.CharSequence, java.lang.CharSequence)</li>
<li><span style='color:orange'>(draft)</span> public java.lang.String <i>getBidiSkeleton</i>(int, java.lang.CharSequence)</li>
</ul>
</ul>
<h3>Package com.ibm.icu.util</h3>
<ul>
Calendar
<ul>
<li><span style='color:orange'>(draft)</span> public static final int ORDINAL_MONTH</li>
<li><span style='color:orange'>(draft)</span> public java.lang.String <i>getTemporalMonthCode</i>()</li>
<li><span style='color:orange'>(draft)</span> public boolean <i>inTemporalLeapYear</i>()</li>
<li><span style='color:orange'>(draft)</span> public void <i>setTemporalMonthCode</i>(java.lang.String)</li>
</ul>
ChineseCalendar
<ul>
<li><span style='color:orange'>(draft)</span> public java.lang.String <i>getTemporalMonthCode</i>()</li>
<li><span style='color:orange'>(draft)</span> public boolean <i>inTemporalLeapYear</i>()</li>
<li><span style='color:orange'>(draft)</span> public void <i>setTemporalMonthCode</i>(java.lang.String)</li>
</ul>
HebrewCalendar
<ul>
<li><span style='color:orange'>(draft)</span> public java.lang.String <i>getTemporalMonthCode</i>()</li>
<li><span style='color:orange'>(draft)</span> public boolean <i>inTemporalLeapYear</i>()</li>
<li><span style='color:orange'>(draft)</span> public void <i>setTemporalMonthCode</i>(java.lang.String)</li>
</ul>
IslamicCalendar
<ul>
<li><span style='color:orange'>(draft)</span> public boolean <i>inTemporalLeapYear</i>()</li>
</ul>
MeasureUnit
<ul>
<li><span style='color:orange'>(draft)</span> public static final MeasureUnit GASOLINE_ENERGY_DENSITY</li>
</ul>
TimeZone
<ul>
<li><span style='color:orange'>(draft)</span> public static java.lang.String <i>getIanaID</i>(java.lang.String)</li>
</ul>
VersionInfo
<ul>
<li><span style='color:green'>(stable)</span> public static final VersionInfo UNICODE_15_1</li>
</ul>
</ul>
<hr/>
<p><i><font size="-1">Contents generated by ReportAPI tool on Fri Mar 17 10:40:39 PDT 2023<br/>© 2023 and later: Unicode, Inc. and others. License & terms of use: <a href="http://www.unicode.org/copyright.html">http://www.unicode.org/copyright.html</a></font></i></p>
<p><i><font size="-1">Contents generated by ReportAPI tool on Thu Sep 21 10:51:41 PDT 2023<br/>© 2023 and later: Unicode, Inc. and others. License & terms of use: <a href="http://www.unicode.org/copyright.html">http://www.unicode.org/copyright.html</a></font></i></p>
</body>
</html>

2
icu4j/main/core/src/main/java/com/ibm/icu/number/FormattedNumber.java
View file

@ -142,7 +142,7 @@ public class FormattedNumber implements FormattedValue {
* supported yet.
*
* @return NounClass
* @draft ICU 71.
* @stable ICU 72
*/
public DisplayOptions.NounClass getNounClass() {
return DisplayOptions.NounClass.fromIdentifier(this.gender);

2
icu4j/main/core/src/main/java/com/ibm/icu/number/NumberFormatterSettings.java
View file

@ -559,7 +559,7 @@ public abstract class NumberFormatterSettings<T extends NumberFormatterSettings<
* the desired case for a unit formatter's output (e.g. accusative, dative, genitive).
*
* @return The fluent chain.
* @draft ICU 72
* @stable ICU 72
*/
public T displayOptions(DisplayOptions displayOptions) {
// `displayCase` does not recognise the `undefined`

172
icu4j/main/core/src/main/java/com/ibm/icu/text/DisplayOptions.java
View file

@ -21,7 +21,7 @@ import java.util.List;
* .build();
* }
*
* @draft ICU 72
* @stable ICU 72
*/
public final class DisplayOptions {
private final GrammaticalCase grammaticalCase;
@ -46,7 +46,7 @@ public final class DisplayOptions {
* Creates a builder with the {@code UNDEFINED} value for all the parameters.
*
* @return Builder
* @draft ICU 72
* @stable ICU 72
*/
public static Builder builder() {
return new Builder();
@ -56,7 +56,7 @@ public final class DisplayOptions {
* Creates a builder with the same parameters from this object.
*
* @return Builder
* @draft ICU 72
* @stable ICU 72
*/
public Builder copyToBuilder() {
return new Builder(this);
@ -66,7 +66,7 @@ public final class DisplayOptions {
* Gets the grammatical case.
*
* @return GrammaticalCase
* @draft ICU 72
* @stable ICU 72
*/
public GrammaticalCase getGrammaticalCase() {
return this.grammaticalCase;
@ -76,7 +76,7 @@ public final class DisplayOptions {
* Gets the noun class.
*
* @return NounClass
* @draft ICU 72
* @stable ICU 72
*/
public NounClass getNounClass() {
return this.nounClass;
@ -86,7 +86,7 @@ public final class DisplayOptions {
* Gets the plural category.
*
* @return PluralCategory
* @draft ICU 72
* @stable ICU 72
*/
public PluralCategory getPluralCategory() {
return this.pluralCategory;
@ -96,7 +96,7 @@ public final class DisplayOptions {
* Gets the capitalization.
*
* @return Capitalization
* @draft ICU 72
* @stable ICU 72
*/
public Capitalization getCapitalization() {
return this.capitalization;
@ -106,7 +106,7 @@ public final class DisplayOptions {
* Gets the name style.
*
* @return NameStyle
* @draft ICU 72
* @stable ICU 72
*/
public NameStyle getNameStyle() {
return this.nameStyle;
@ -116,7 +116,7 @@ public final class DisplayOptions {
* Gets the display length.
*
* @return DisplayLength
* @draft ICU 72
* @stable ICU 72
*/
public DisplayLength getDisplayLength() {
return this.displayLength;
@ -126,7 +126,7 @@ public final class DisplayOptions {
* Gets the substitute handling.
*
* @return SubstituteHandling
* @draft ICU 72
* @stable ICU 72
*/
public SubstituteHandling getSubstituteHandling() {
return this.substituteHandling;
@ -135,7 +135,7 @@ public final class DisplayOptions {
/**
* Responsible for building {@code DisplayOptions}.
*
* @draft ICU 72
* @stable ICU 72
*/
public static class Builder {
private GrammaticalCase grammaticalCase;
@ -149,7 +149,7 @@ public final class DisplayOptions {
/**
* Creates a {@code DisplayOptions.Builder} with the default values.
*
* @draft ICU 72
* @stable ICU 72
*/
private Builder() {
this.grammaticalCase = GrammaticalCase.UNDEFINED;
@ -165,7 +165,7 @@ public final class DisplayOptions {
* Creates a {@code Builder} with all the information from a {@code DisplayOptions}.
*
* @param displayOptions Options to be copied.
* @draft ICU 72
* @stable ICU 72
*/
private Builder(DisplayOptions displayOptions) {
this.grammaticalCase = displayOptions.grammaticalCase;
@ -182,7 +182,7 @@ public final class DisplayOptions {
*
* @param grammaticalCase The grammatical case.
* @return Builder
* @draft ICU 72
* @stable ICU 72
*/
public Builder setGrammaticalCase(GrammaticalCase grammaticalCase) {
this.grammaticalCase = grammaticalCase;
@ -194,7 +194,7 @@ public final class DisplayOptions {
*
* @param nounClass The noun class.
* @return Builder
* @draft ICU 72
* @stable ICU 72
*/
public Builder setNounClass(NounClass nounClass) {
this.nounClass = nounClass;
@ -206,7 +206,7 @@ public final class DisplayOptions {
*
* @param pluralCategory The plural category.
* @return Builder
* @draft ICU 72
* @stable ICU 72
*/
public Builder setPluralCategory(PluralCategory pluralCategory) {
this.pluralCategory = pluralCategory;
@ -218,7 +218,7 @@ public final class DisplayOptions {
*
* @param capitalization The capitalization.
* @return Builder
* @draft ICU 72
* @stable ICU 72
*/
public Builder setCapitalization(Capitalization capitalization) {
this.capitalization = capitalization;
@ -230,7 +230,7 @@ public final class DisplayOptions {
*
* @param nameStyle The name style.
* @return Builder
* @draft ICU 72
* @stable ICU 72
*/
public Builder setNameStyle(NameStyle nameStyle) {
this.nameStyle = nameStyle;
@ -242,7 +242,7 @@ public final class DisplayOptions {
*
* @param displayLength The display length.
* @return Builder
* @draft ICU 72
* @stable ICU 72
*/
public Builder setDisplayLength(DisplayLength displayLength) {
this.displayLength = displayLength;
@ -254,7 +254,7 @@ public final class DisplayOptions {
*
* @param substituteHandling The substitute handling.
* @return Builder
* @draft ICU 72
* @stable ICU 72
*/
public Builder setSubstituteHandling(SubstituteHandling substituteHandling) {
this.substituteHandling = substituteHandling;
@ -265,7 +265,7 @@ public final class DisplayOptions {
* Builds the display options.
*
* @return DisplayOptions
* @draft ICU 72
* @stable ICU 72
*/
public DisplayOptions build() {
DisplayOptions displayOptions = new DisplayOptions(this);
@ -276,46 +276,46 @@ public final class DisplayOptions {
/**
* Represents all the grammatical noun classes that are supported by CLDR.
*
* @draft ICU 72
* @stable ICU 72
*/
public enum NounClass {
/**
* A possible setting for NounClass. The noun class context to be used is unknown (this is the
* default value).
*
* @draft ICU 72
* @stable ICU 72
*/
UNDEFINED("undefined"),
/**
* @draft ICU 72
* @stable ICU 72
*/
OTHER("other"),
/**
* @draft ICU 72
* @stable ICU 72
*/
NEUTER("neuter"),
/**
* @draft ICU 72
* @stable ICU 72
*/
FEMININE("feminine"),
/**
* @draft ICU 72
* @stable ICU 72
*/
MASCULINE("masculine"),
/**
* @draft ICU 72
* @stable ICU 72
*/
ANIMATE("animate"),
/**
* @draft ICU 72
* @stable ICU 72
*/
INANIMATE("inanimate"),
/**
* @draft ICU 72
* @stable ICU 72
*/
PERSONAL("personal"),
/**
* @draft ICU 72
* @stable ICU 72
*/
COMMON("common");
@ -328,14 +328,14 @@ public final class DisplayOptions {
/**
* Unmodifiable List of all noun classes constants. List version of {@link #values()}.
*
* @draft ICU 72
* @stable ICU 72
*/
public static final List<NounClass> VALUES =
Collections.unmodifiableList(Arrays.asList(NounClass.values()));
/**
* @return the lowercase CLDR keyword string for the noun class.
* @draft ICU 72
* @stable ICU 72
*/
public final String getIdentifier() {
return this.identifier;
@ -344,7 +344,7 @@ public final class DisplayOptions {
/**
* @param identifier in lower case such as "feminine" or "masculine"
* @return the plural category corresponding to the identifier, or {@code UNDEFINED}
* @draft ICU 72
* @stable ICU 72
*/
public static final NounClass fromIdentifier(String identifier) {
if (identifier == null) {
@ -364,35 +364,35 @@ public final class DisplayOptions {
/**
* Represents all the name styles.
*
* @draft ICU 72
* @stable ICU 72
*/
public enum NameStyle {
/**
* A possible setting for NameStyle. The NameStyle context to be used is unknown (this is the
* default value).
*
* @draft ICU 72
* @stable ICU 72
*/
UNDEFINED,
/**
* Use standard names when generating a locale name, e.g. en_GB displays as 'English (United
* Kingdom)'.
*
* @draft ICU 72
* @stable ICU 72
*/
STANDARD_NAMES,
/**
* Use dialect names, when generating a locale name, e.g. en_GB displays as 'British English'.
*
* @draft ICU 72
* @stable ICU 72
*/
DIALECT_NAMES;
/**
* Unmodifiable List of all name styles constants. List version of {@link #values()}.
*
* @draft ICU 72
* @stable ICU 72
*/
public static final List<NameStyle> VALUES =
Collections.unmodifiableList(Arrays.asList(NameStyle.values()));
@ -401,35 +401,35 @@ public final class DisplayOptions {
/**
* Represents all the substitute handlings.
*
* @draft ICU 72
* @stable ICU 72
*/
public enum SubstituteHandling {
/**
* A possible setting for SubstituteHandling. The SubstituteHandling context to be used is
* unknown (this is the default value).
*
* @draft ICU 72
* @stable ICU 72
*/
UNDEFINED,
/**
* Returns a fallback value (e.g., the input code) when no data is available. This is the
* default behaviour.
*
* @draft ICU 72
* @stable ICU 72
*/
SUBSTITUTE,
/**
* Returns a null value when no data is available.
*
* @draft ICU 72
* @stable ICU 72
*/
NO_SUBSTITUTE;
/**
* Unmodifiable List of all substitute handlings constants. List version of {@link #values()}.
*
* @draft ICU 72
* @stable ICU 72
*/
public static final List<SubstituteHandling> VALUES =
Collections.unmodifiableList(Arrays.asList(SubstituteHandling.values()));
@ -438,34 +438,34 @@ public final class DisplayOptions {
/**
* Represents all the display lengths.
*
* @draft ICU 72
* @stable ICU 72
*/
public enum DisplayLength {
/**
* A possible setting for DisplayLength. The DisplayLength context to be used is unknown (this
* is the default value).
*
* @draft ICU 72
* @stable ICU 72
*/
UNDEFINED,
/**
* Uses full names when generating a locale name, e.g. "United States" for US.
*
* @draft ICU 72
* @stable ICU 72
*/
LENGTH_FULL,
/**
* Use short names when generating a locale name, e.g. "U.S." for US.
*
* @draft ICU 72
* @stable ICU 72
*/
LENGTH_SHORT;
/**
* Unmodifiable List of all display lengths constants. List version of {@link #values()}.
*
* @draft ICU 72
* @stable ICU 72
*/
public static final List<DisplayLength> VALUES =
Collections.unmodifiableList(Arrays.asList(DisplayLength.values()));
@ -474,14 +474,14 @@ public final class DisplayOptions {
/**
* Represents all the capitalization options.
*
* @draft ICU 72
* @stable ICU 72
*/
public enum Capitalization {
/**
* A possible setting for Capitalization. The capitalization context to be used is unknown (this
* is the default value).
*
* @draft ICU 72
* @stable ICU 72
*/
UNDEFINED,
@ -489,7 +489,7 @@ public final class DisplayOptions {
* The capitalization context if a date, date symbol or display name is to be formatted with
* capitalization appropriate for the beginning of a sentence.
*
* @draft ICU 72
* @stable ICU 72
*/
BEGINNING_OF_SENTENCE,
@ -497,7 +497,7 @@ public final class DisplayOptions {
* The capitalization context if a date, date symbol or display name is to be formatted with
* capitalization appropriate for the middle of a sentence.
*
* @draft ICU 72
* @stable ICU 72
*/
MIDDLE_OF_SENTENCE,
@ -506,7 +506,7 @@ public final class DisplayOptions {
* capitalization appropriate for stand-alone usage such as an isolated name on a calendar
* page.
*
* @draft ICU 72
* @stable ICU 72
*/
STANDALONE,
@ -514,14 +514,14 @@ public final class DisplayOptions {
* The capitalization context if a date, date symbol or display name is to be formatted with
* capitalization appropriate for a user-interface list or menu item.
*
* @draft ICU 72
* @stable ICU 72
*/
UI_LIST_OR_MENU;
/**
* Unmodifiable List of all the capitalizations constants. List version of {@link #values()}.
*
* @draft ICU 72
* @stable ICU 72
*/
public static final List<Capitalization> VALUES =
Collections.unmodifiableList(Arrays.asList(Capitalization.values()));
@ -530,44 +530,44 @@ public final class DisplayOptions {
/**
* Standard CLDR plural category constants. See http://www.unicode.org/reports/tr35/tr35-numbers.html#Language_Plural_Rules
*
* @draft ICU 72
* @stable ICU 72
*/
public enum PluralCategory {
/**
* A possible setting for PluralCategory. The plural category context to be used is unknown
* (this is the default value).
*
* @draft ICU 72
* @stable ICU 72
*/
UNDEFINED("undefined"),
/**
* @draft ICU 72
* @stable ICU 72
*/
ZERO("zero"),
/**
* @draft ICU 72
* @stable ICU 72
*/
ONE("one"),
/**
* @draft ICU 72
* @stable ICU 72
*/
TWO("two"),
/**
* @draft ICU 72
* @stable ICU 72
*/
FEW("few"),
/**
* @draft ICU 72
* @stable ICU 72
*/
MANY("many"),
/**
* @draft ICU 72
* @stable ICU 72
*/
OTHER("other");
@ -580,14 +580,14 @@ public final class DisplayOptions {
/**
* Unmodifiable List of all plural categories constants. List version of {@link #values()}.
*
* @draft ICU 72
* @stable ICU 72
*/
public static final List<PluralCategory> VALUES =
Collections.unmodifiableList(Arrays.asList(PluralCategory.values()));
/**
* @return the lowercase CLDR keyword string for the plural category
* @draft ICU 72
* @stable ICU 72
*/
public final String getIdentifier() {
return this.identifier;
@ -596,7 +596,7 @@ public final class DisplayOptions {
/**
* @param identifier in lower case such as "few" or "other"
* @return the plural category corresponding to the identifier, or {@code UNDEFINED}
* @draft ICU 72
* @stable ICU 72
*/
public static final PluralCategory fromIdentifier(String identifier) {
if (identifier == null) {
@ -616,84 +616,84 @@ public final class DisplayOptions {
/**
* Represents all the grammatical cases that are supported by CLDR.
*
* @draft ICU 72
* @stable ICU 72
*/
public enum GrammaticalCase {
/**
* A possible setting for GrammaticalCase. The grammatical case context to be used is unknown
* (this is the default value).
*
* @draft ICU 72
* @stable ICU 72
*/
UNDEFINED("undefined"),
/**
* @draft ICU 72
* @stable ICU 72
*/
ABLATIVE("ablative"),
/**
* @draft ICU 72
* @stable ICU 72
*/
ACCUSATIVE("accusative"),
/**
* @draft ICU 72
* @stable ICU 72
*/
COMITATIVE("comitative"),
/**
* @draft ICU 72
* @stable ICU 72
*/
DATIVE("dative"),
/**
* @draft ICU 72
* @stable ICU 72
*/
ERGATIVE("ergative"),
/**
* @draft ICU 72
* @stable ICU 72
*/
GENITIVE("genitive"),
/**
* @draft ICU 72
* @stable ICU 72
*/
INSTRUMENTAL("instrumental"),
/**
* @draft ICU 72
* @stable ICU 72
*/
LOCATIVE("locative"),
/**
* @draft ICU 72
* @stable ICU 72
*/
LOCATIVE_COPULATIVE("locative_copulative"),
/**
* @draft ICU 72
* @stable ICU 72
*/
NOMINATIVE("nominative"),
/**
* @draft ICU 72
* @stable ICU 72
*/
OBLIQUE("oblique"),
/**
* @draft ICU 72
* @stable ICU 72
*/
PREPOSITIONAL("prepositional"),
/**
* @draft ICU 72
* @stable ICU 72
*/
SOCIATIVE("sociative"),
/**
* @draft ICU 72
* @stable ICU 72
*/
VOCATIVE("vocative");
@ -706,14 +706,14 @@ public final class DisplayOptions {
/**
* Unmodifiable List of all grammatical cases constants. List version of {@link #values()}.
*
* @draft ICU 72
* @stable ICU 72
*/
public static final List<GrammaticalCase> VALUES =
Collections.unmodifiableList(Arrays.asList(GrammaticalCase.values()));
/**
* @return the lowercase CLDR keyword string for the grammatical case.
* @draft ICU 72
* @stable ICU 72
*/
public final String getIdentifier() {
return this.identifier;
@ -722,7 +722,7 @@ public final class DisplayOptions {
/**
* @param identifier in lower case such as "dative" or "nominative"
* @return the plural category corresponding to the identifier, or {@code UNDEFINED}
* @draft ICU 72
* @stable ICU 72
*/
public static final GrammaticalCase fromIdentifier(String identifier) {
if (identifier == null) {