MessageFormatter::create

MessageFormatter::__construct

msgfmt_create

Constructs a new Message Formatter

&reftitle.description;

&style.oop; (method)

public static ``MessageFormatter``null```MessageFormatter::create` `string` `locale` `string` `pattern`

&style.oop; (constructor):

public `MessageFormatter::__construct` `string` `locale` `string` `pattern`

&style.procedural;

``MessageFormatter``null```msgfmt_create` `string` `locale` `string` `pattern`

Constructs a new Message Formatter

&reftitle.parameters;

`locale`

- The locale to use when formatting arguments

`pattern`

- The pattern string to stick arguments into. The pattern uses an 'apostrophe-friendly' syntax; see Quoting/Escaping for details.

&reftitle.returnvalues;

The formatter `object`, or &null; on failure.

&reftitle.errors;

When invoked as constructor, on failure an `IntlException` is thrown.

&reftitle.examples;

### `msgfmt_create` example

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

&example.outputs;

    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

&reftitle.seealso;

- `msgfmt_format`
- `msgfmt_parse`
- `msgfmt_get_error_code`
- `msgfmt_get_error_message`