PluralRules 類別

定義

[Android.Runtime.Register("android/icu/text/PluralRules", ApiSince=24, DoNotGenerateAcw=true)]
public class PluralRules : Java.Lang.Object, IDisposable, Java.IO.ISerializable

[<Android.Runtime.Register("android/icu/text/PluralRules", ApiSince=24, DoNotGenerateAcw=true)>]
type PluralRules = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

繼承

Object

JavaObject

Object

PluralRules

屬性

RegisterAttribute

實作

IJavaObject IJavaPeerable ISerializable IDisposable

備註

定義將非負數值映射到一小組關鍵字的規則。

規則是由文字描述構成，內容包含一系列關鍵字與條件。 該 #select 方法依序檢查每個條件，並回傳第一個與該數字相符條件的關鍵字。 若無匹配 #KEYWORD_OTHER ，則回傳。

複數規則物件是不可變的。 它包含取樣值的快取，但這些快取是同步的。

PluralRules 是可序列化的，因此可用於格式化器，而格式化器本身也可序列化。

欲了解更多資訊、細節及撰寫規則的技巧，請參閱 LDML 規範，第 3.5 部分 語言複數規則

範例：

"one: n is 1; few: n in 2..4"

這定義了兩條規則，分別是「一」和「少數」。 「一」的條件是「n 是 1」，表示該數字必須等於 1 才能通過此條件。 「少」的條件是「n 在 2..4」中，意即該數字必須介於 2 到 4 之間，且為整數，條件才會成立。 其他所有號碼依預設規則被賦予關鍵字「other」。

"zero: n is 0; one: n is 1; zero: n mod 100 in 1..19"

這說明同一個關鍵字可以被多次定義。 每條規則依序檢視，第一個條件通過的關鍵詞即為返回的。 另外注意，最後一條規則中對 n 應用了一個模量。 因此，其條件對119、219、319......

"one: n is 1; few: n mod 10 in 2..4 and n mod 100 not in 12..14"

這說明了合取與否定。 「少」的條件包含兩部分，兩者都必須滿足：「n mod 10 in 2..4」和「n mod 100 not in 12..14」。 第一部分在測試前對 n 施加模數，如前例所示。 第二部分則採用不同的模數，並使用否定，因此它匹配 所有不 屬於12、13、14、112、113、114、212、213、214......的數字。

Syntax:

rules         = rule (';' rule)*
            rule          = keyword ':' condition
            keyword       = <identifier>
            condition     = and_condition ('or' and_condition)*
            and_condition = relation ('and' relation)*
            relation      = not? expr not? rel not? range_list
            expr          = ('n' | 'i' | 'f' | 'v' | 't') (mod value)?
            not           = 'not' | '!'
            rel           = 'in' | 'is' | '=' | '≠' | 'within'
            mod           = 'mod' | '%'
            range_list    = (range | value) (',' range_list)*
            value         = digit+
            digit         = 0|1|2|3|4|5|6|7|8|9
            range         = value'..'value

每個 <b>not</b> 詞都會顛倒其意義;但不應有超過一個。

i、f、t 和 v 的值定義如下：

<ul><li>i 是整數數字。</li><li f>為可見的十進位數字，作為整數。</li><li t>為可見的十進位數字——不含尾數零——作為整數。</li><li>v 表示可見分數數字的數量。</li><li j>定義為僅匹配整數。 也就是說，j 是 3 失敗，若 v ！= 0（例如 3.1 或 3.0）。</li></ul>

以下表格中舉例：

<表格邊框='1' style=“border-collapse： collapse”><tbody><tr><th>n</th><th>i</th><th>f/th<>th< v></th></tr><tr><td>1.0</td><td>1</td><td align=“right”0></td><td>1</td></tr><tr td><>1.00</td><td>1</tdTD 對齊=“右”0></TD><TD>2</TD></TR><TR TD><>1.3</TD><TD>1</TDD><TD 對齊=“Right”>3</TDD><TD 1></TD></TR><TR><TD>1.03</TD><>TD 1</TD><TD 對齊=“Right”>3</TDD><TD>2</TD></TR TR><><><TD 1.23/TDD><>TD 1</TD><TD align=“Right”>23</TD><TD>2</TD></TR></Tbody></Table><>

「識別碼」是一串不具備 Unicode Pattern_Syntax或Pattern_White_Space屬性的字元序列。

「in」與「within」的差別在於，「in」只包含指定範圍內的整數，而「within」則包含所有值。 在完全由數值組成的range_list中使用「within」與使用「in」是相同的（這不是錯誤）。

Java 文件 android.icu.text.PluralRules。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。