array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'class.messageformatter.php', 1 => 'MessageFormatter', 2 => 'La clase MessageFormatter', ), 'up' => array ( 0 => 'book.intl.php', 1 => 'intl', ), 'prev' => array ( 0 => 'normalizer.normalize.php', 1 => 'Normalizer::normalize', ), 'next' => array ( 0 => 'messageformatter.create.php', 1 => 'MessageFormatter::create', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/intl/messageformatter.xml', ), 'history' => array ( ), 'extra_header_links' => array ( 'rel' => 'alternate', 'href' => '/manual/en/feeds/class.messageformatter.atom', 'type' => 'application/atom+xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

La clase MessageFormatter

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

Introducción

MessageFormatter es una clase concreta que permite producir mensajes concatenados, independientes del idioma. Las métodos proporcionadas en esta clase se utilizan para construir mensajes que están destinados a los usuarios finales.

La clase MessageFormatter ensambla los mensajes a partir de diferentes fragmentos (textos, números y fechas), proporcionados por el programa. Gracias a la clase MessageFormatter, el programa no necesita conocer el orden de los fragmentos. La clase utiliza especificaciones de formato para ensamblar los fragmentos en un solo mensaje. Por ejemplo, MessageFormatter permite mostrar la frase "Finalizado de imprimir x fichero sobre y..." de una manera que permanece flexible para la traducción.

Anteriormente, un mensaje se creaba en forma de frase, y se gestionaba como un string. Este procedimiento generaba problemas para las traducciones, ya que la estructura de la frase, el orden de las palabras, el formato de los números, etc. era muy diferente de un idioma a otro. El enfoque de creación de mensajes, independiente del idioma, permite separar el mensaje y las variables. Con estas variables, MessageFormatter puede concatenar las diferentes partes del mensaje, formatearlas según las convenciones correctas, y proporcionar un mensaje bien formado.

MessageFormatter toma una serie de objetos, formatea los textos, y los inserta en los strings formateados en los emplazamientos correctos. Una amplia variedad de formatos puede ser utilizada en conjunción con MessageFormatter para gestionar el plural, los números, etc. Típicamente, el mensaje es proporcionado por un recurso, y los argumentos son preparados dinámicamente.

Sinopsis de la Clase

class MessageFormatter {
/* Métodos */
public __construct(string $locale, string $pattern)
public static create(string $locale, string $pattern): ?MessageFormatter
public format(array $values): string|false
public static formatMessage(string $locale, string $pattern, array $values): string|false
public getErrorCode(): int
public getErrorMessage(): string
public getLocale(): string
public getPattern(): string|false
public parse(string $string): array|false
public static parseMessage(string $locale, string $pattern, string $message): array|false
public setPattern(string $pattern): bool
}

Tabla de contenidos