Please wait while we load your page...


PHP Manual :: MessageFormatter::formatMessage

MessageFormatter::create || MessageFormatter::format || MessageFormatter || PHP Manual

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

MessageFormatter::formatMessage -- msgfmt_format_messageQuick format message


Object oriented style

public static string MessageFormatter::formatMessage ( string $locale , string $pattern , array $args )

Procedural style

string msgfmt_format_message ( string $locale , string $pattern , array $args )

Quick formatting function that formats the string without having to explicitly create the formatter object. Use this function when the format operation is done only once and does not need and parameters or state to be kept.



The locale to use for formatting locale-dependent parts


The pattern string to insert things into. The pattern uses an 'apostrophe-friendly' syntax; it is run through » umsg_autoQuoteApostrophe before being interpreted.


The array of values to insert into the format string

Return Values

The formatted pattern string or FALSE if an error occurred


Example #1 msgfmt_format_message() example

echo msgfmt_format_message("en_US""{0,number,integer} monkeys on {1,number,integer} trees make {2,number} monkeys per tree\n", array(45601234560/123));
msgfmt_format_message("de""{0,number,integer} Affen auf {1,number,integer} Bäumen sind {2,number} Affen pro Baum\n", array(45601234560/123));

Example #2 OO example

echo MessageFormatter::formatMessage("en_US""{0,number,integer} monkeys on {1,number,integer} trees make {2,number} monkeys per tree\n", array(45601234560/123));
MessageFormatter::formatMessage("de""{0,number,integer} Affen auf {1,number,integer} Bäumen sind {2,number} Affen pro Baum\n", array(45601234560/123));

The above example will output:

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

See Also

MessageFormatter::create || MessageFormatter::format || MessageFormatter || PHP Manual
Live Chat Not Available