PluralFormat Classe

Definizione

[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

Ereditarietà

Object

Object

_Format

UFormat

PluralFormat

Attributi

RegisterAttribute

Commenti

PluralFormat supporta la creazione di messaggi internazionalizzati con un'inflessione plurale. Si basa sulla selezione plurale, ad esempio il chiamante specifica i messaggi per ogni caso plurale che può essere visualizzato nella lingua dell'utente e PluralFormat seleziona il messaggio appropriato in base al numero.

<h3>Il problema delle forme plurali nei messaggi< internazionalizzati/h3>

Diverse lingue hanno modi diversi per inflect plurali. La creazione di messaggi internazionalizzati che includono forme plurali è fattibile solo quando il framework è in grado di gestire correttamente forme plurali di tutte le lingue. ChoiceFormat non gestisce questa operazione, perché allega un intervallo numerico a ogni messaggio e seleziona il messaggio il cui intervallo contiene un determinato numero. Questo può gestire solo un numero finito di intervalli. Ma in alcune lingue, come il polacco, un caso plurale si applica a intervalli infinitamente molti (ad esempio, il caso di sospensione si applica ai numeri che terminano con 2, 3 o 4 tranne quelli che terminano con 12, 13 o 14). Pertanto ChoiceFormat , non è adeguato.

PluralFormat gestisce questo problema suddividendo il problema in due parti: <ul><li>Usa PluralRules che può definire condizioni più complesse per un caso plurale rispetto a un solo intervallo. Queste regole plurali definiscono sia i casi plurali presenti in una lingua che i numeri a cui si applicano questi casi. <li>Fornisce regole plurali predefinite per molte lingue. Pertanto, il programmatore non deve preoccuparsi dei casi plurali di una lingua e non deve definire i casi plurali; possono semplicemente usare le parole chiave predefinite. L'intera formattazione plurale dei messaggi può essere eseguita usando modelli localizzati da bundle di risorse. Per le regole plurali predefinite, vedere la pagina Regole plurali del linguaggio CLDR in https://unicode-org.github.io/cldr-staging/charts/latest/supplemental/language_plural_rules.html</ul>

<h4 Utilizzo di >PluralFormat/h4<>

Nota: in genere, la formattazione plurale viene eseguita tramite MessageFormat con un plural tipo di argomento, invece di usare un oggetto autonomo PluralFormat.

Questa discussione presuppone che l'utente usi PluralFormat con un set predefinito di regole plurali. È possibile crearne uno usando uno dei costruttori che accetta un ULocale oggetto . Per specificare il modello di messaggio, è possibile passarlo al costruttore o impostarlo in modo esplicito usando il applyPattern() metodo . Il format() metodo accetta un oggetto number e seleziona il messaggio del caso plurale corrispondente. Questo messaggio verrà restituito.

<modelli h5>e la loro interpretazione</h5>

Il testo del criterio definisce l'output del messaggio per ogni caso plurale delle impostazioni locali specificate. Sintassi: <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 tra gli elementi della sintassi viene ignorato, tranne tra le parentesi graffe} e il relativo sotto-messaggio e tra '=' e il numero di un valore explicitValue.

Esistono 6 parole chiave case predefinite in CLDR/ICU - 'zero', 'one', 'two', 'few', 'many' e 'other'. È sempre necessario definire un testo del messaggio per il caso plurale predefinito "other" contenuto in ogni set di regole. Se non si specifica un testo del messaggio per un caso plurale specifico, il testo del messaggio del caso plurale "other" viene assegnato a questo caso plurale.

Durante la formattazione, il numero di input viene prima confrontato con le clausole explicitValue. Se non è presente alcuna corrispondenza esatta, viene selezionata una parola chiave chiamando PluralRules con il numero di <input em>meno l'offset</em>. L'offset viene impostato su 0 per impostazione predefinita se viene omesso dalla stringa del criterio. Se non è presente alcuna clausola con tale parola chiave, vengono restituite le clausole "other".

Un segno di cancelletto non racchiuso tra virgoole (#) nel sottomessagio selezionato (ad esempio, all'esterno degli argomenti annidati nel sottomessagio) viene sostituito dal numero di input meno l'offset. Il valore number-minus-offset viene formattato usando un NumberFormat valore per le PluralFormatimpostazioni locali. Se è necessaria una formattazione numerica speciale, è necessario usare un MessageFormat oggetto e specificare in modo esplicito un NumberFormat argomento. <nota forte>:/strong< L'argomento> è formattato senza sottrarre l'offset. Se è necessario un formato personalizzato e un offset diverso da zero, è necessario passare il valore number-minus-offset come parametro separato.

Per un esempio di utilizzo, vedere la documentazione della MessageFormat classe.

<h4>Definizione di regole< plurali personalizzate/h4>

Se è necessario usare PluralFormat con regole personalizzate, è possibile creare un PluralRules oggetto e passarlo al PluralFormatcostruttore di . Se si specificano anche impostazioni locali in questo costruttore, queste impostazioni locali verranno utilizzate per formattare il numero nei testi del messaggio.

Per altre informazioni su PluralRules, vedere PluralRules.

per android.icu.text.PluralFormat.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.