メッセージをフォーマットする

# MessageFormatter::format

# msgfmt_format

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

MessageFormatter::format -- msgfmt_format — メッセージをフォーマットする

### 説明

オブジェクト指向型

public function MessageFormatter::format(array `$values`): string|false

手続き型

function msgfmt_format(MessageFormatter `$formatter`, array `$values`): string|false

ロケールの規則にしたがってデータをフォーマット文字列に埋め込み、 メッセージをフォーマットします。

### パラメータ

`formatter`

  メッセージのフォーマッタ。

`values`

  フォーマット文字列に埋め込む引数。

### 戻り値

フォーマットした文字列を返します。 あるいはエラーが発生した場合は `false` を返します。

### 例

例1 msgfmt_format() の例

    <?php
    $fmt = msgfmt_create("en_US", "{0,number,integer} monkeys on {1,number,integer} trees make {2,number} monkeys per tree");
    echo msgfmt_format($fmt, array(4560, 123, 4560/123));
    $fmt = msgfmt_create("de", "{0,number,integer} Affen auf {1,number,integer} Bäumen sind {2,number} Affen pro Baum");
    echo msgfmt_format($fmt, array(4560, 123, 4560/123));
    ?>

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

    <?php
    $fmt = new MessageFormatter("en_US", "{0,number,integer} monkeys on {1,number,integer} trees make {2,number} monkeys per tree");
    echo $fmt->format(array(4560, 123, 4560/123));
    $fmt = new MessageFormatter("de", "{0,number,integer} Affen auf {1,number,integer} Bäumen sind {2,number} Affen pro Baum");
    echo $fmt->format(array(4560, 123, 4560/123));
    ?>

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

    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

### 参考

- msgfmt_create() - 新しいメッセージフォーマッタを作成する
- msgfmt_parse() - パターンを使用して入力文字列をパースする
- msgfmt_format_message() - 手早くメッセージをフォーマットする
- msgfmt_get_error_code() - 直近の操作のエラーコードを取得する
- msgfmt_get_error_message() - 直近の操作のエラーテキストを取得する

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open