msgfmt_format_message(3) [php 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)

MSGFMT_SET_PATTERN(3)							 1						     MSGFMT_SET_PATTERN(3)

MessageFormatter::setPattern - Set the pattern used by the formatter

	Object oriented style

SYNOPSIS

       public bool MessageFormatter::setPattern (string  $pattern)

DESCRIPTION

	Procedural style
       bool msgfmt_set_pattern (MessageFormatter  $fmt, string	$pattern)

	Set the pattern used by the formatter

PARAMETERS

	      o $fmt
		- The message formatter

	      o $pattern
		-  The	pattern  string  to  use  in  this  message formatter. The pattern uses an 'apostrophe-friendly' syntax; it is run through
		umsg_autoQuoteApostrophe before being interpreted.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      msgfmt_set_pattern(3) example

	      <?php
	      $fmt = msgfmt_create( "en_US", "{0, number} monkeys on {1, number} trees" );
	      echo "Default pattern: '" . msgfmt_get_pattern( $fmt ) . "'
";
	      echo "Formatting result: " . msgfmt_format( $fmt, array(123, 456) ) . "
";

	      msgfmt_set_pattern( $fmt, "{0, number} trees hosting {1, number} monkeys" );
	      echo "New pattern: '" . msgfmt_get_pattern( $fmt ) . "'
";
	      echo "Formatted number: " . msgfmt_format( $fmt, array(123, 456) ) . "
";
	      ?>

       Example #2

	      OO example

	      <?php
	      $fmt = new MessageFormatter( "en_US", "{0, number} monkeys on {1, number} trees" );
	      echo "Default pattern: '" . $fmt->getPattern() . "'
";
	      echo "Formatting result: " . $fmt->format(array(123, 456)) . "
";

	      $fmt->setPattern("{0, number} trees hosting {1, number} monkeys" );
	      echo "New pattern: '" . $fmt->getPattern() . "'
";
	      echo "Formatted number: " . $fmt->format(array(123, 456)) . "
";
	      ?>

       The above example will output:

       Default pattern: '{0,number} monkeys on {1,number} trees'
       Formatting result: 123 monkeys on 456 trees
       New pattern: '{0,number} trees hosting {1,number} monkeys'
       Formatted number: 123 trees hosting 456 monkeys

SEE ALSO

       msgfmt_create(3), msgfmt_get_pattern(3).

PHP Documentation Group 												     MSGFMT_SET_PATTERN(3)