Edit Report a Bug

    MessageFormatter::formatMessage

    msgfmt_format_message

    (PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

    MessageFormatter::formatMessage -- msgfmt_format_message — 手早くメッセージをフォーマットする

    説明

    オブジェクト指向型

    public static MessageFormatter::formatMessage(string $locale, string $pattern, array $values): string|false

    手続き型

    msgfmt_format_message(string $locale, string $pattern, array $values): string|false

    明示的にフォーマッタオブジェクトを作成せずに、 手早くメッセージをフォーマットする関数です。 この関数を使用するのは、 一度きりのフォーマット処理であってパラメータや状態を保持する必要がない場合か、 追加のコンテキストを ICU に直接与えることで、出力をカスタマイズしたい場合です。

    パラメータ

    locale

    ロケールに依存する部分をフォーマットする際に使用するロケール。

    pattern

    使用するパターン文字列。 パターンには、'アポストロフィに優しい' 構文を使用します。 詳細は » Quoting/Escaping を参照ください。

    values

    フォーマット文字列に埋め込む値の配列。

    戻り値

    フォーマットしたパターン文字列を返します。 エラーが発生した場合は false を返します。

    例

    例1 msgfmt_format_message() の例

    <?php
    echo msgfmt_format_message("en_US", "{0,number,integer} monkeys on {1,number,integer} trees make {2,number} monkeys per tree\n", array(4560, 123, 4560/123));
    echo     msgfmt_format_message("de", "{0,number,integer} Affen auf {1,number,integer} Bäumen sind {2,number} Affen pro Baum\n", array(4560, 123, 4560/123));
    echo     msgfmt_format_message("en", 'You finished {place, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}!', ['place' => 3]), "\n";
    echo     msgfmt_format_message("en",
    "There {apple, plural,
    =0 {are no apples}
    =1 {is one apple...}
    other {are # apples!}
    }"    ,
    [    'apple' => 0]
    ),     "\n";

    例2 オブジェクト指向の例

    <?php
    echo MessageFormatter::formatMessage("en_US", "{0,number,integer} monkeys on {1,number,integer} trees make {2,number} monkeys per tree\n", array(4560, 123, 4560/123));
    echo     MessageFormatter::formatMessage("de", "{0,number,integer} Affen auf {1,number,integer} Bäumen sind {2,number} Affen pro Baum\n", array(4560, 123, 4560/123));
    echo     MessageFormatter::formatMessage("en", 'You finished {place, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}!', ['place' => 3]), "\n";
    echo     MessageFormatter::formatMessage("en",
    "There {apple, plural,
    =0 {are no apples}
    =1 {is one apple...}
    other {are # apples!}
    }"    ,
    [    'apple' => 0]
    ),     "\n";

    上の例の出力は以下となります。

    4,560 monkeys on 123 trees make 37.073 monkeys per tree
4.560 Affen auf 123 Bäumen sind 37,073 Affen pro Baum
You finished 3rd!
There are no apples

    例3 通常の通貨記号と、短い形式の通貨記号を使ってフォーマットするよう、ICU に指示する

    ICU ≥ 67 が必要です

    <?php
    echo msgfmt_format_message("cs_CZ", "{0, number, :: currency/CAD}", array(123.45));
    echo     msgfmt_format_message("cs_CZ", "{0, number, :: currency/CAD unit-width-narrow}", array(123.45));

    上の例の出力は以下となります。

    123,45 CA$
123,45 $

    参考

    add a note add a note

    User Contributed Notes 3 notes

    up
    5
    zlobnygrif at gmail dot com
    11 years ago
    <?php
    var_dump    (
          msgfmt_format_message('ru_RU', 'The value of {somekey} is {0, choice, 0 #less 12| 12 #between 12 and 32| 32 #more than 32}', ['SomeAnotherKey' => -1]),
          msgfmt_format_message('ru_RU', 'The value of {somekey} is {0, choice, 0 #less 12| 12 #between 12 and 32| 32 #more than 32}', [14]),
          msgfmt_format_message('ru_RU', 'The value of {somekey} is {0, choice, 0 #less 12| 12 #between 12 and 32| 32 #more than 32}', [133]),
          msgfmt_format_message('ru_RU', '{0, plural, =0{Zero}=1{One}other{Unknown #}}', [0]),
          msgfmt_format_message('ru_RU', '{0, plural, =0{Zero}=1{One}other{Unknown #}}', [1]),
          msgfmt_format_message('ru_RU', '{0, plural, =0{Zero}=1{One}other{Unknown #}}', [2]),
          msgfmt_format_message('ru_RU', '{0, select, somevalue{This is some value} other{Unknown value}}', ['somevalue']),
          msgfmt_format_message('ru_RU', '{0, select, somevalue{This is some value} other{Unknown value "{0}"}}', ['somevalue2'])
    );

    var_dump(
          msgfmt_format_message('en_GB', 'Peter has {0, plural, =0{no cat} =1{a cat} other{# cats}}', [0]),
          msgfmt_format_message('en_GB', 'Peter has {0, plural, =0{no cat} =1{a cat} other{# cats}}', [1]),
          msgfmt_format_message('en_GB', 'Peter has {0, plural, =0{no cat} =1{a cat} other{# cats}}', [2])
    );
    ?>

    Output (PHP 5.4.17RC1)
    ==========================
    string 'The value of -1 is less 12' (length=26)
    string 'The value of 14 is between 12 and 32' (length=36)
    string 'The value of 133 is more than 32' (length=32)
    string 'Zero' (length=4)
    string 'One' (length=3)
    string 'Unknown 2' (length=9)
    string 'This is some value' (length=18)
    string 'Unknown value "somevalue2"' (length=26)
    string 'Peter has no cat' (length=16)
    string 'Peter has a cat' (length=15)
    string 'Peter has 2 cats' (length=16)
    up
    2
    ricardoyubal at gmail dot com
    3 years ago
    Although not mentioned, single quotes (') are used internally as escaping characters. So if you want to have them in your output, you should escape them with another single quote. See examples below.

    <?php

    // The value {foo} should be enclosed in single quotes
    echo msgfmt_format_message('en_US', "The value '{foo}' should be enclosed in single quotes", ['foo' => 'bar']);

    // The value 'bar' should be enclosed in single quotes
    echo msgfmt_format_message('en_US', "The value ''{foo}'' should be enclosed in single quotes", ['foo' => 'bar']);

    ?>
    up
    1
    contact at sowapps dot com
    3 years ago
    For now, there is now way to define a default value.

    <?php
    echo msgfmt_format_message('fr_FR', '{distance, plural, =0{Here}other{# km}}', []);
    // Show {distance}
    ?>
    add a note add a note
    To Top