getQuantityString

最新推荐文章于 2024-05-01 16:13:01 发布

DroidEye

最新推荐文章于 2024-05-01 16:13:01 发布

阅读量1.2k

点赞数

本文介绍Android中如何使用复数字符串资源，以适应不同语言的语法特性，特别是针对数量变化的表述。通过XML文件定义不同数量级对应的字符串，并演示了如何在代码中调用。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Quantity Strings（复数）

不同的语言对数量进行描述的语法规则也不同。比如在英语里，数量1是个特殊情况，我们写成“1 book”，但其他任何数量都要写成“n books”。这种单复数之间的区别是很普遍的，不过其他语言会有更好的区分方式。Android支持的全集包括zero、one、 two、few、many和other。

决定选择和使用某种语言和复数的规则是非常复杂的，所以Android提供了诸如getQuantityString()的方法来选择合适的资源。

注意，要按照语法规则来建立可选项。在英语里，即使数量为0，字符串零（zero）也不需要建立。因为0在英语语法表达上和2没有区别，和其他除1以外的任何数字都没有差别（"zero books", "one book", "two books"，等等）。不要被“two听起来似乎只能用于数量2” 样的事误导。某语言可能需要2、12、102（等等）和1一样形式表示，而又与其他数的形式都不同。请依靠翻译人员来了解一下实际语言中的差别。

如果和应用程序的风格一致，常可以用诸如“Books: 1”的模糊数量形式来避免使用数量字符串。这会让你和翻译人员都轻松些。

注意：复数字符串是简单类型资源，是用名称（name）（而不是XML文件名）来直接引用的。因此，在一个XML文件里，可以把复数字符串资源和其他简单类型资源一起放在一个<resources>元素下。

文件位置

res/values/filename.xml

文件名可随意指定。<plurals>元素的名字name将被用作资源ID。

资源引用

Java代码:：R.plurals.plural_name

语法

<?xml version="1.0" encoding="utf-8"?>

<plurals

name="plural_name">

<item_plurals

quantity=["zero" | "one" | "two" | "few" | "many" | "other"]

>text_string</item>

</plurals>

</resources>

元素

必填项。必须是根元素。

无属性。

一个字符串集，每个数量表示提供一个字符串。包含一个或多个<item>元素。

属性：

name

String类型。字符串对的名称。此名称将作为资源ID。

<item>

一个单数或复数形式的字符串。可以是对其他字符串资源的引用。必须作为<plurals>元素的子元素存在。注意须对单引号和双引号进行转义。有关如何正确地样式化及格式化字符串，请参阅下文格式化和样式化。

属性：

quantity

关键字。表示要使用此字符串的数量值。以下是合法的值（括号内列出部分语言要求）：

值	描述
zero	语言需要对数字0进行特殊处理。（比如阿拉伯语）
one	语言需要对类似1的数字进行特殊处理。（比如英语和其它大多数语言里的1；在俄语里，任何以1结尾但不以11结尾的数也属于此类型。）
two	语言需要对类似2的数字进行特殊处理。（比如威尔士语）
few	语言需要对较小数字进行特殊处理（比如捷克语里的2、3、4；或者波兰语里以2、3、4结尾但不是12、13、14的数。）
many	语言需要对较大数字进行特殊处理（比如马耳他语里以11-99结尾的数）
other	语言不需要对数字进行特殊处理。

示例

存放在res/values/strings.xml 的XML文件：

<?xml version="1.0" encoding="utf-8"?>

<item quantity="one">One song found.</item>

<item quantity="other">%d songs found.</item>

</plurals>

</resources>

存放在res/values-pl/strings.xml 的XML文件：

<?xml version="1.0" encoding="utf-8"?>

<item quantity="one">Znaleziono jedną piosenkę.</item>

<item quantity="few">Znaleziono %d piosenki.</item>

<item quantity="other">Znaleziono %d piosenek.</item>

</plurals>

</resources>

Java代码：

int count = getNumberOfsongsAvailable();

Resources res = getResources();

String songsFound = res.getQuantityString(R.plurals.numberOfSongsAvailable, count,count);

在使用getQuantityString()方法时，如果字符串包含数字格式化串，则需要传递2个count参数。例如：对于字符串“%d songs found”，第一个count参数选择合适的复数字符串，第二个count参数插入占位符%d中。如果复数字符串资源不包含格式化信息，就不需要给getQuantityString()传递第三个参数。