messageformatter(3) [php man page]

MESSAGEFORMATTER(3)							 1						       MESSAGEFORMATTER(3)

The MessageFormatter class

INTRODUCTION

	MessageFormatter  is  a concrete class that enables users to produce concatenated, language-neutral messages. The methods supplied in this
       class are used to build all the messages that are seen by end users.

	The MessageFormatter class assembles messages from various fragments (such as text fragments, numbers, and dates) supplied by the program.
       Because of the MessageFormatter class, the program does not need to know the order of the fragments. The class uses the formatting specifi-
       cations for the fragments to assemble them into a message that is contained in a single string within a resource bundle. For example,  Mes-
       sageFormatter  enables  you  to	print  the phrase "Finished printing x out of y files..." in a manner that still allows for flexibility in
       translation.

	Previously, an end user message was created as a sentence and handled as a string. This procedure created problems for localizers  because
       the  sentence structure, word order, number format and so on are very different from language to language. The language-neutral way to cre-
       ate messages keeps each part of the message separate and provides keys to the data. Using these keys, the MessageFormatter class  can  con-
       catenate the parts of the message, localize them, and display a well-formed string to the end user.

	MessageFormatter  takes a set of objects, formats them, and then inserts the formatted strings into the pattern at the appropriate places.
       Choice formats can be used in conjunction with MessageFormatter to handle plurals, match numbers, and select from an array of items.  Typi-
       cally, the message format will come from resources and the arguments will be dynamically set at runtime.

CLASS SYNOPSIS

       MessageFormatter

       MessageFormatter

       Methods

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

       o publicstatic MessageFormatter MessageFormatter::create (string  $locale, string  $pattern)

       o publicstatic string MessageFormatter::formatMessage (string  $locale, string  $pattern, array	$args)

       o public string MessageFormatter::format (array	$args)

       o public int MessageFormatter::getErrorCode (void  )

       o public string MessageFormatter::getErrorMessage (void	)

       o public string MessageFormatter::getLocale (void  )

       o public string MessageFormatter::getPattern (void  )

       o publicstatic array MessageFormatter::parseMessage (string  $locale, string  $pattern, string  $source)

       o public array MessageFormatter::parse (string  $value)

       o public bool MessageFormatter::setPattern (string  $pattern)

SEE ALSO

	      o ICU formatting documentation

	      o ICU message formatting description

	      oICU message formatters

	      oICU choice formatters

PHP Documentation Group 												       MESSAGEFORMATTER(3)

Check Out this Related Man Page

MSGFMT_FORMAT_MESSAGE(3)						 1						  MSGFMT_FORMAT_MESSAGE(3)

MessageFormatter::formatMessage - Quick format message

	Object oriented style

SYNOPSIS

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

DESCRIPTION

	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.

PARAMETERS

	      o $locale
		- The locale to use for formatting locale-dependent parts

	      o $pattern
		- The pattern string to insert things into. The pattern uses an 'apostrophe-friendly' syntax; it is run  through  umsg_autoQuoteA-
		postrophe before being interpreted.

	      o $args
		- The array of values to insert into the format string

RETURN VALUES

	The formatted pattern string or FALSE if an error occurred

EXAMPLES

       Example #1

	      msgfmt_format_message(3) example

	      <?php
	      echo msgfmt_format_message("en_US", "{0,number,integer} monkeys on {1,number,integer} trees make {2,number} monkeys per tree
", array(4560, 123, 4560/123));
	      echo msgfmt_format_message("de", "{0,number,integer} Affen auf {1,number,integer} Baumen sind {2,number} Affen pro Baum
", array(4560, 123, 4560/123));
	      ?>

       Example #2

	      OO example

	      <?php
	      echo MessageFormatter::formatMessage("en_US", "{0,number,integer} monkeys on {1,number,integer} trees make {2,number} monkeys per tree
", array(4560, 123, 4560/123));
	      echo MessageFormatter::formatMessage("de", "{0,number,integer} Affen auf {1,number,integer} Baumen sind {2,number} Affen pro Baum
", array(4560, 123, 4560/123));
	      ?>

       The above example will output:

       4,560 monkeys on 123 trees make 37.073 monkeys per tree
       4.560 Affen auf 123 Baumen sind 37,073 Affen pro Baum

SEE ALSO

       msgfmt_create(3), msgfmt_parse(3), msgfmt_get_error_code(3), msgfmt_get_error_message(3).

PHP Documentation Group 												  MSGFMT_FORMAT_MESSAGE(3)

Linux and UNIX Man Pages

messageformatter(3) [php man page]

Check Out this Related Man Page