如何使用 Android 数量字符串（复数）

Question

我正在尝试使用资源中的getQuantityString方法根据 Android 开发人员指南数量字符串（复数）检索数量字符串（复数）

我得到的错误是

错误：(604) 以非位置格式指定的多个替换； 您是要添加 formatted="false" 属性吗？
错误：(604) 在预期位置找到标签

当我如下设置复数时

<plurals name="productCount">
    <item quantity="one" formatted="true">%1$d of %2$d product</item>
    <item quantity="other" formatted="true">%1$d of %2$d products</item>
</plurals>

并尝试按以下方式阅读它 productIndexCountText.setText(getResources().getQuantityString(R.plurals.productCount, position, size));

一种解决方法是将字符串分解为仅对字符串的最后部分使用复数形式，然后将这两部分连接起来。 但如果可能的话，我会尽量避免这样做。

Answer 1

您不需要为这些项目中的任何一个设置“格式化”属性。 使用数量字符串时，只有三种可能：

1. 资源字符串是纯文本，不包含任何参数
2. 资源字符串只包含一个参数（很可能是数量）； 使用%d或您需要的任何格式
3. 资源字符串包含多个参数； 所有参数都必须通过它们的位置显式访问，例如%1$d

对于getQuantityString方法，有两种重载：一种只有资源 ID 和数量，另一种带有额外的Object... formatArgs参数。

对于情况 1.，您可以使用getQuantityString(@PluralsRes int id, int quantity)方法。

对于所有其他情况，即如果您有任何参数，则需要getQuantityString(@PluralsRes int id, int quantity, Object... formatArgs)重载。 注意：所有参数都必须存在于参数数组中。 这意味着，如果资源字符串显示数量，则数量变量将被传递两次给函数。

那是因为在解析资源字符串的位置参数时不考虑方法本身的quantity参数。

所以如果这些是你的资源，

<resources>
    <plurals name="test0">
        <item quantity="one">Test ok</item>
        <item quantity="other">Tests ok</item>
    </plurals>
    <plurals name="test1">
        <item quantity="one">%d test ok</item>
        <item quantity="other">%d tests ok</item>
    </plurals>
    <plurals name="test2">
        <item quantity="one">%2$s: %1$d test ok</item>
        <item quantity="other">%2$s: %1$d tests ok</item>
    </plurals>
    <plurals name="test3">
        <item quantity="one">%3$s: %1$d test out of %2$d ok</item>
        <item quantity="other">%3$s: %1$d tests out of %2$d ok</item>
    </plurals>
</resources>

那么对getQuantityString的适当调用是：

int success = 1;
int total = 10;
String group = "Group name";

getResources().getQuantityString(R.plurals.test0, success)
// Test ok
getResources().getQuantityString(R.plurals.test1, success, success)
// 1 test ok
getResources().getQuantityString(R.plurals.test2, success, success, group)
// Group name: 1 test ok
getResources().getQuantityString(R.plurals.test3, success, success, total, group)
// Group name: 1 test out of 10 ok

success = 5;
getResources().getQuantityString(R.plurals.test0, success)
// Tests ok
getResources().getQuantityString(R.plurals.test1, success, success)
// 5 tests ok
getResources().getQuantityString(R.plurals.test2, success, success, group)
// Group name: 5 tests ok
getResources().getQuantityString(R.plurals.test3, success, success, total, group)
// Group name: 5 tests out of 10 ok

---

数量类：了解quantity参数

如上所述，关键是要了解getQuantityString的quantity参数不用于替换%d或%1$d等占位符。 相反，它用于从plurals本身结合资源文件的区域设置确定适当的item 。

但是请注意，与属性名称及其可能值（ zero 、 one 、 two 、 few 、 many 、 other ）可能建议的相比，这是一种不太直接的映射。 例如，即使quantity参数的值为 0，提供额外的<item quantity="zero">也不起作用（至少不是英文） 。

原因是 Android 中plurals工作方式是通过数量类的概念。 数量类是在给定语言中具有相同语法规则的一组数量值。 这至关重要的意味着

• 使用了哪些数量类别，以及
• 哪些数值被映射到它们

取决于相应资源文件所在的区域设置。

重要的是要了解这两个问题仅由语法必要性决定。 以下是一些示例：

• 在中文或韩文中，只使用other ，因为在这些语言中，句子在语法上不会根据给定的数量而有所不同。
• 在英语中，有两类： one类用于文字值 1， other用于所有其他值，包括 0。
• 在爱尔兰，1被映射到one ，2被映射到two ，3-6是few ，7-10是many 0和11+是other 。
• 在斯洛文尼亚语中，值 1和所有以 01结尾的值都映射为one (1, 101, 3001, ...)。 2 和以 02 结尾的值被映射到two (2, 302, 1002, ...)。 3, 4 和以 03 或 04 结尾的值被映射到few (3, 4, 6004, ...)。 其他任何东西都是other （0、11、48、312，...）。
• 在波兰语中，5-19 和以 05-19 结尾的值被映射到many (5, 12, 216, 4711, ...)。 以 2、3 或 4 结尾的值（包括 2-4 本身）映射到few (3, 42, 103, 12035374, ...)。 然而，这尊重 12、13 和 14 是此规则的例外，因为它们映射到many 。 （旁注：是的，从语法上讲，5多而 12035374少。）
• 亚美尼亚语就像英语，除了值 0 也映射到one ，因为这就是它们的语法工作方式。 你可以从这个例子中看到，数量类one甚至不一定只代表一个数字。

如您所见，确定正确的数量类别会变得相当复杂。 这就是为什么getQuantityString已经根据quantity参数和资源文件的区域设置为您执行此操作的原因。 Android（大部分）所遵循的规则在Unicode Common Locale Data Repository的语言复数规则中定义。 这也是数量类名称的来源。

所有这一切意味着翻译任何数量字符串所需的一组数量类可能因语言而异（中文只需要other ，英语需要one和other ，爱尔兰只需要zero等）。 但是，在一种语言中，所有plurals都应具有相同数量的项目，涵盖该特定语言所需的所有数量类别。

结论

对getQuantityString的调用可以这样理解：

int success = 5;
int total = 10;
String group = "Group name";

getResources().getQuantityString(R.plurals.test3, success, success, total, group)
//                               \_____________/  \_____/  \___________________/
//                                      |            |               |
//         id: used to get the plurals resource      |               |
//   quantity: used to determine the appropriate quantity class      |
// formatArgs: used to positionally replace the placeholders %1, %2 and %3

quantity参数的值为“5”意味着使用的item将是来自中文、韩语、英语、斯洛文尼亚语和亚美尼亚语资源文件的数量类other item ，爱尔兰语few ，波兰语many 。

---

我还要简要提到两种特殊情况：

非整数

基本上，选择的类再次取决于特定于语言的规则。 选择类的方式既不通用，也不保证涵盖所有整数规则所需的任何类也可用于任何非整数。 这里有一些例子：

• 对于英语，任何带小数的值将始终映射到other 。
• 对于斯洛文尼亚语，任何带有小数的值将始终映射到few 。
• 对于爱尔兰语，选择取决于整数部分。
• 对于波兰语，与整数的复杂规则相反，非整数总是映射到other比如英语。

注意：根据语言复数规则，这是应该的。 唉，Android 目前还没有现成的float或double方法。

一个字符串中的多个数量

如果您的显示文本有多个数量，例如%d match(es) found in %d file(s). ，将其拆分为三个独立的资源：

1. %d match(es)项（ plurals项）
2. %d file(s) （ plurals项）
3. %1$s found in %2$s. （普通参数化strings项）

然后，您可以对 1 和 2 对getQuantityString进行适当的调用，然后对第三个对getString进行另一次调用，将前两个容易本地化的字符串作为formatArgs 。

原因是允许翻译人员在语言需要时切换第三个资源中的参数顺序。 例如，如果假设语言中唯一有效的语法是In %d file(s) it found %d match(es). ，译者可以照常翻译复数，然后将第三个资源翻译为In %2$s it found %1$s. 考虑交换的订单。