MessageFormatter::formatMessage

msgfmt_format_message

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

MessageFormatter::formatMessage -- msgfmt_format_messageFormatea rápidamente un mensaje

Descripción

Estilo orientado a objetos

public static MessageFormatter::formatMessage(string $locale, string $pattern, array $values): string|false

Estilo por procedimientos

msgfmt_format_message(string $locale, string $pattern, array $values): string|false

Función de formato rápido que formatea una cadena sin necesidad de crear explícitamente un objeto de formato. Utilice esta función cuando la operación de formato se realiza una sola vez y no es necesario conservar parámetros o estados, o cuando se desea personalizar la salida proporcionando directamente un contexto adicional a ICU.

Parámetros

locale

La configuración local a utilizar para el formato

pattern

El chaîne de caractères en el cual se deben insertar los datos. El patrón utiliza una sintaxis que acepta comillas; Ver » Quoting/Escaping para más detalles.

values

El tableau de valores a insertar en la cadena de formato.

Valores devueltos

La cadena formateada, o bien false si ocurre un error.

Ejemplos

Ejemplo #1 Ejemplo con msgfmt_format_message(), estilo procedimental

<?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));
echo
msgfmt_format_message("en", 'You finished {place, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}!', ['place' => 3]), "\n";
echo
msgfmt_format_message("en",
"There {apple, plural,
=0 {are no apples}
=1 {is one apple...}
other {are # apples!}
}"
,
[
'apple' => 0]
),
"\n";

Ejemplo #2 Ejemplo con msgfmt_format_message(), estilo procedimental

<?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));
echo
MessageFormatter::formatMessage("en", 'You finished {place, selectordinal, one {#st} two {#nd} few {#rd} other {#th}}!', ['place' => 3]), "\n";
echo
MessageFormatter::formatMessage("en",
"There {apple, plural,
=0 {are no apples}
=1 {is one apple...}
other {are # apples!}
}"
,
[
'apple' => 0]
),
"\n";

El resultado del ejemplo sería:

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
You finished 3rd!
There are no apples

Ejemplo #3 Solicitar a ICU que formatee la moneda con el símbolo monetario común y con el símbolo monetario corto.

Requiere ICU ≥ 67.

<?php
echo msgfmt_format_message("cs_CZ", "{0, number, :: currency/CAD}", array(123.45));
echo
msgfmt_format_message("cs_CZ", "{0, number, :: currency/CAD unit-width-narrow}", array(123.45));

El resultado del ejemplo sería:

123,45 CA$
123,45 $

Ver también