PluralFormat Klasse

Definition

[Android.Runtime.Register("android/icu/text/PluralFormat", ApiSince=24, DoNotGenerateAcw=true)]
public class PluralFormat : Android.Icu.Text.UFormat

[<Android.Runtime.Register("android/icu/text/PluralFormat", ApiSince=24, DoNotGenerateAcw=true)>]
type PluralFormat = class
    inherit UFormat

Vererbung

Object

JavaObject

Object

_Format

UFormat

PluralFormat

Attribute

RegisterAttribute

Hinweise

PluralFormat unterstützt die Erstellung von internationalisierten Nachrichten mit pluraler Umflung. Sie basiert auf der Pluralauswahl, d. h. der Aufrufer gibt Nachrichten für jeden pluralen Fall an, der in der Sprache des Benutzers angezeigt werden kann und die PluralFormat entsprechende Nachricht basierend auf der Nummer auswählt.

<h3>Das Problem der Pluralformen in internationalisierten Nachrichten</h3>

Verschiedene Sprachen haben unterschiedliche Möglichkeiten, Plurale zu inflect plurals. Das Erstellen von internationalisierten Nachrichten, die Pluralformen enthalten, ist nur möglich, wenn das Framework plurale Formen aller Sprachen richtig verarbeiten kann. ChoiceFormat behandelt dies nicht gut, da sie jeder Nachricht ein Nummernintervall hinzufügt und die Nachricht auswählt, deren Intervall eine bestimmte Zahl enthält. Dies kann nur eine begrenzte Anzahl von Intervallen verarbeiten. In einigen Sprachen wie Polnisch gilt jedoch ein pluraler Fall für unendlich viele Intervalle (z. B. gilt der paukale Fall für Zahlen, die mit 2, 3 oder 4 enden, außer denen, die mit 12, 13 oder 14 enden). Daher ChoiceFormat ist es nicht angemessen.

PluralFormat befasst sich damit, indem das Problem in zwei Teile unterteilt wird: <ul><li>Es verwendet PluralRules , die komplexere Bedingungen für einen pluralen Fall als nur ein einzelnes Intervall definieren können. Diese Pluralregeln definieren sowohl, welche Pluralfälle in einer Sprache vorhanden sind, als auch für welche Zahlen diese Fälle gelten. <li>Es stellt vordefinierte Pluralregeln für viele Sprachen bereit. Daher muss sich der Programmierer nicht um die pluralen Fälle einer Sprache kümmern und muss nicht die pluralen Fälle definieren; sie können einfach die vordefinierten Schlüsselwörter verwenden. Die gesamte plurale Formatierung von Nachrichten kann mithilfe lokalisierter Muster aus Ressourcenbündeln erfolgen. Informationen zu vordefinierten Pluralregeln finden Sie auf der Seite "CLDR Language Plural Rules " unter https://unicode-org.github.io/cldr-staging/charts/latest/supplemental/language_plural_rules.html</ul>

<h4>Nutzung von PluralFormat</h4>

Hinweis: In der Regel erfolgt die Pluralformatierung über MessageFormat einen plural Argumenttyp, anstatt eine eigenständige PluralFormatFormatierung zu verwenden.

In dieser Diskussion wird davon ausgegangen, dass Sie mit einem vordefinierten Satz von Pluralregeln arbeiten PluralFormat . Sie können einen erstellen, indem Sie einen der Konstruktoren verwenden, die ein ULocale Objekt verwenden. Um das Nachrichtenmuster anzugeben, können Sie es entweder an den Konstruktor übergeben oder explizit mithilfe der applyPattern() Methode festlegen. Die format() Methode verwendet ein Zahlenobjekt und wählt die Nachricht des übereinstimmenden Plural-Falls aus. Diese Nachricht wird zurückgegeben.

<h5>Muster und ihre Interpretation</h5>

Der Mustertext definiert die Nachrichtenausgabe für jeden pluralen Fall des angegebenen Gebietsschemas. Syntax: <Blockquote>

pluralStyle = [offsetValue] (selector '{' message '}')+
            offsetValue = "offset:" number
            selector = explicitValue | keyword
            explicitValue = '=' number  // adjacent, no white space in between
            keyword = [^[[:Pattern_Syntax:][:Pattern_White_Space:]]]+
            message: see {@link MessageFormat}

</blockquote> Pattern_White_Space zwischen Syntaxelementen wird ignoriert, außer zwischen den {curly braces} und deren Unternachricht und zwischen dem '=' und der Anzahl eines expliziten Werts.

Es gibt 6 vordefinierte Fallstichwörter in CLDR/ICU - "zero", "one", "two", "few", "many" und "other". Sie müssen immer einen Nachrichtentext für den Standardmäßigen Pluralfall "other" definieren, der in jedem Regelsatz enthalten ist. Wenn Sie keinen Nachrichtentext für einen bestimmten pluralen Fall angeben, wird der Nachrichtentext des pluralen Falls "other" diesem pluralen Fall zugewiesen.

Beim Formatieren wird die Eingabenummer zuerst mit den explicitValue-Klauseln abgeglichen. Wenn keine genaue Zahl gefunden wird, wird ein Schlüsselwort ausgewählt, indem die PluralRules Eingabenummer <em>minus dem Offset</em> aufgerufen wird. (Der Offset ist standardmäßig auf 0 festgelegt, wenn er aus der Musterzeichenfolge weggelassen wird.) Wenn es keine Klausel mit diesem Schlüsselwort gibt, werden die "other"-Klauseln zurückgegeben.

Ein unquotetes Nummernzeichen (#) in der ausgewählten Unternachricht selbst (d. h. außerhalb der in der Unternachricht geschachtelten Argumente) wird durch die Eingabenummer minus des Offsets ersetzt. Der Zahlen-Minus-Offset-Wert wird mit einem NumberFormat für das PluralFormatGebietsschema 's' formatiert. Wenn Sie eine spezielle Zahlenformatierung benötigen, müssen Sie ein MessageFormatNumberFormat Argument verwenden und explizit angeben. <strong>Hinweis:</strong> Dieses Argument ist Formatierung, ohne den Offset zu subtrahieren! Wenn Sie ein benutzerdefiniertes Format benötigen und einen Offset ungleich Null aufweisen, müssen Sie den Wert für den Zahlen-Minus-Offset als separaten Parameter übergeben.

Ein Verwendungsbeispiel finden Sie in der MessageFormat Klassendokumentation.

<h4>Definieren von benutzerdefinierten Pluralregeln</h4>

Wenn Sie mit benutzerdefinierten Regeln arbeiten PluralFormat müssen, können Sie ein PluralRules Objekt erstellen und an PluralFormatden Konstruktor übergeben. Wenn Sie auch ein Gebietsschema in diesem Konstruktor angeben, wird dieses Gebietsschema verwendet, um die Zahl in den Nachrichtentexten zu formatieren.

Weitere Informationen zu PluralRules finden Sie unter PluralRules.

Java Dokumentation für android.icu.text.PluralFormat.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.