PluralFormat クラス

定義

[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

継承

Object

JavaObject

Object

_Format

UFormat

PluralFormat

属性

RegisterAttribute

注釈

PluralFormat は、複数の変曲を伴う国際化メッセージの作成をサポートしています。 複数 形の選択に基づいています。つまり、呼び出し元は、ユーザーの言語で表示できる複数形のケースごとにメッセージを指定し、 PluralFormat は番号に基づいて適切なメッセージを選択します。

<h3>国際化メッセージにおける複数形の問題</h3>

言語によって、複数形を取り込む方法が異なります。 複数形を含む国際化メッセージの作成は、フレームワーク がすべての 言語の複数形を正しく処理できる場合にのみ可能です。 ChoiceFormat は、各メッセージに数値の間隔を添付し、その間隔に特定の番号が含まれるメッセージを選択するため、この処理を適切に行いません。 これは、有限の間隔のみを処理できます。 ただし、ポーランド語などの一部の言語では、1 つの複数形のケースが無限に多くの間隔に適用されます (たとえば、12、13、または 14 で終わる数値を除き、2、3、または 4 で終わる数値に一時停止ケースが適用されます)。 したがって、 ChoiceFormat は十分ではありません。

PluralFormat これは、問題を 2 つの部分に分割することによって対処します。 <ul><li>単一の間隔よりも複数形のケースに対してより複雑な条件を定義できる PluralRules を使用します。 これらの複数形の規則は、言語に存在する複数形のケースと、これらのケースに適用される数値の両方を定義します。 <li>多くの言語に対して定義済みの複数形ルールを提供します。 したがって、プログラマは言語の複数形のケースについて心配する必要はありませんし、複数形のケースを定義する必要はありません。定義済みのキーワードを使用できます。 メッセージの複数形全体の書式設定は、リソース バンドルのローカライズされたパターンを使用して行うことができます。 定義済みの複数形ルールについては、「CLDR 言語の複数形ルール 」ページ ( https://unicode-org.github.io/cldr-staging/charts/latest/supplemental/language_plural_rules.html</ul) を参照してください。>

<h4>PluralFormat</h4 の使用>

注: 通常、複数形の書式設定は、スタンドアロンのMessageFormatを使用するのではなく、plural引数型のPluralFormatを使用して行われます。

この説明では、定義済みの複数形ルールのセットで PluralFormat を使用することを前提としています。 ULocale オブジェクトを受け取るコンストラクターのいずれかを使用して作成できます。 メッセージ パターンを指定するには、それをコンストラクターに渡すか、 applyPattern() メソッドを使用して明示的に設定します。 format()メソッドは、数値オブジェクトを受け取り、一致する複数形のケースのメッセージを選択します。 このメッセージが返されます。

<h5>パターンとその解釈</h5>

パターン テキストは、指定されたロケールの複数形のケースごとにメッセージ出力を定義します。 構文: <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 は無視されます。{中かっこ} とそのサブメッセージの間、および '=' と explicitValue の数の間を除きます。

CLDR/ICU には、"zero"、"one"、"two"、"few"、"many"、"other" の 6 つの定義済みのケース キーワードがあります。 すべてのルール セットに含まれる既定の複数形ケース "other" のメッセージ テキストを常に定義する必要があります。 特定の複数形のケースにメッセージ テキストを指定しない場合は、複数形のケース "other" のメッセージ テキストがこの複数形のケースに割り当てられます。

書式設定時に、最初に入力番号が explicitValue 句と照合されます。 正確な数値が一致しない場合は、オフセットPluralRules/em<の入力番号>em<minus で>を呼び出すことによってキーワードが選択されます。 (パターン文字列から省略すると、オフセットの既定値は 0 になります)。そのキーワードを持つ句がない場合は、"other" 句が返されます。

選択したサブメッセージ自体 (つまり、サブメッセージに入れ子になった引数の外側) の引用符で囲まれていないシャープ記号 (#) は、入力番号からオフセットを引いた値に置き換えられます。 数値マイナス オフセット値は、NumberFormatのロケールのPluralFormatを使用して書式設定されます。 特殊な数値書式が必要な場合は、 MessageFormat を使用し、 NumberFormat 引数を明示的に指定する必要があります。 <strong>Note:</strong> この引数はオフセットを減算せずに書式設定されます。 カスタム形式が必要で、オフセットが 0 以外の場合は、数値から負のオフセット値を別のパラメーターとして渡す必要があります。

使用例については、 MessageFormat クラスのドキュメントを参照してください。

<h4>カスタム複数形ルールの定義</h4>

カスタム 規則で PluralFormat を使用する必要がある場合は、 PluralRules オブジェクトを作成し、それを PluralFormatのコンストラクターに渡すことができます。 このコンストラクターでロケールも指定した場合、このロケールはメッセージ テキスト内の数値の書式設定に使用されます。

PluralRules の詳細については、「PluralRules」を参照してください。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。