MessageFormatter::formatMessage
msgfmt_format_message
(PHP 5 >= 5.3.0, PHP 7, PECL intl >= 1.0.0)
MessageFormatter::formatMessage -- msgfmt_format_message — 手早くメッセージをフォーマットする
説明
オブジェクト指向型
public
static
string
MessageFormatter::formatMessage
( string
$locale
, string $pattern
, array $args
)手続き型
string
msgfmt_format_message
( string
$locale
, string $pattern
, array $args
)明示的にフォーマッタオブジェクトを作成せずに、 手早くメッセージをフォーマットする関数です。 この関数を使用するのは、 一度きりのフォーマット処理であってパラメータや状態を保持する必要がない場合です。
パラメータ
-
locale -
ロケールに依存する部分をフォーマットする際に使用するロケール。
-
pattern -
使用するパターン文字列。 パターンには、'アポストロフィに優しい' 構文を使用します。 » umsg_autoQuoteApostrophe を通してから解釈が行われます。
-
args -
フォーマット文字列に埋め込む値の配列。
返り値
フォーマットしたパターン文字列を返します。
エラーが発生した場合は 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));
?>
例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));
?>
上の例の出力は以下となります。
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_get_error_code() - 直近の操作のエラーコードを取得する
- msgfmt_get_error_message() - 直近の操作のエラーテキストを取得する
忘却曲線を使ってこの知識を確実に記憶に残す
