<i18n dev> RFR: 8041488: Locale-Dependent List Patterns [v7]

[Joe Wang]

On Thu, 10 Aug 2023 16:59:14 GMT, Naoto Sato <naoto at openjdk.org> wrote:

>> src/java.base/share/classes/java/text/ListFormat.java line 58:
>> 
>>> 56:  *     .format(List.of("Foo", "Bar", "Baz"))
>>> 57:  * }
>>> 58:  * This will produce the concatenated list string, "Foo, Bar, and Baz" as seen in
>> 
>> With this sample code, if the Style is changed to SHORT, it would produce the same string. Would it be better to use the weekdays instead of Foo, Bar and Baz (as in the Unicode spec)? Esp. with the UNIT type, those examples explained it better, e.g. NARROW produces 3′ 7″.
>> 
>> Also, if the instance is of STANDARD/SHORT, does it format List.of("January", "February", "March") and return "Jan., Feb., and Mar.", or 3 feet, 7 inches to 3 ft, 7 in? The format method states simply "Returns the string that consists of the input strings, concatenated with the patterns of this ListFormat."  I wonder if it'd be helpful to explain a bit more or add one more sample.
>
> In fact, the sample in LDML's page seems to be incorrect. `standard-short` in English is defined as:
> 
> 		<listPattern type="standard-short">
> 			<listPatternPart type="start">{0}, {1}</listPatternPart>
> 			<listPatternPart type="middle">{0}, {1}</listPatternPart>
> 			<listPatternPart type="end">{0}, & {1}</listPatternPart>
> 			<listPatternPart type="2">{0} & {1}</listPatternPart>
> 		</listPattern>
> 
> in `en.xml` file. So `&` is expected rather than `and`.
> 
>> Also, if the instance is of STANDARD/SHORT, does it format List.of("January", "February", "March") and return "Jan., Feb., and Mar.", or 3 feet, 7 inches to 3 ft, 7 in?
> 
> No it does not. The `format()` method does not alter the passed input strings, so it would not convert "January" to "Jan." even if `SHORT` Style is specified. I have added some extra explanations, that those patterns vary depending on the locale providers.

Ah, I see. Those samples did give an impression that the format does more than concatenation.

-------------

PR Review Comment: https://git.openjdk.org/jdk/pull/15130#discussion_r1290711203