php8.5
Home/ Manual/ intl / messageformatter/ MessageFormatter::format

MessageFormatter::format

PHP function Edit on GitHub ✎

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

Format the message

Description

Oop

MessageFormatter::format(array $values): string|false

Procedural

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

Format the message by substituting the data into the format string according to the locale rules

Parameters

formatter

The message formatter

values

Arguments to insert into the format string

Return Values

The formatted string, or false if an error occurred

Examples

msgfmt_format() example

php
<?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));
?>

OO example

php
<?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));
?>

The above example will output:

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

Source: reference/intl/messageformatter/format.xml · from the official PHP manual (php/doc-en)