Edit Report a Bug

MessageFormatter::create

MessageFormatter::__construct

msgfmt_create

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

MessageFormatter::create -- MessageFormatter::__construct -- msgfmt_create — Создаёт средство форматирования сообщений

Описание

Объектно-ориентированный стиль (метод)

public static MessageFormatter::create(string $locale, string $pattern): ?MessageFormatter

Объектно-ориентированный стиль (конструктор):

public MessageFormatter::__construct(string $locale, string $pattern)

Процедурный стиль

msgfmt_create(string $locale, string $pattern): ?MessageFormatter

Создаёт средство форматирования сообщений.

Список параметров

locale: Локаль, используемая при форматировании аргументов
pattern: Строка (string) шаблона для вставки аргументов. В шаблоне используется "дружественный к апострофам" синтаксис; подробнее смотрите в разделе » Quoting/Escaping.

Возвращаемые значения

Объект MessageFormatter или null в случае возникновения ошибки.

Ошибки

При вызове в качестве конструктора в случае возникновения ошибки выбрасывается исключение IntlException.

Примеры

Пример #1 Пример использования msgfmt_create()

<?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_format() - Форматирует сообщение
msgfmt_parse() - Разбирает строку согласно шаблону
msgfmt_get_error_code() - Возвращает код ошибки последней операции
msgfmt_get_error_message() - Возвращает текст ошибки последней операции

add a note

User Contributed Notes 1 note

down

ezarko at synacor dot com ¶

15 years ago


Beware: passing an empty string for format returns null, not a formatter which returns empty strings.

$ php -r "print_r(new MessageFormatter('en_US',' '));"
MessageFormatter Object
(
)
$ php -r "print_r(new MessageFormatter('en_US',''));"

add a note