MessageFormatter::parseMessage

msgfmt_parse_message

Quick parse input string

&reftitle.description;

&style.oop;

public static ``array``false```MessageFormatter::parseMessage` `string` `locale` `string` `pattern` `string` `message`

&style.procedural;

``array``false```msgfmt_parse_message` `string` `locale` `string` `pattern` `string` `message`

Parses input string without explicitly creating the formatter object. Use this function when the format operation is done only once and does not need any parameters or state to be kept.

&reftitle.parameters;

`locale`

- The locale to use for parsing locale-dependent parts

`pattern`

- The pattern with which to parse the `message`.

`message`

- The `string` to parse, conforming to the `pattern`.

&reftitle.returnvalues;

An `array` containing items extracted, or &false; on error

&reftitle.examples;

### `msgfmt_parse_message` example

    <?php
    $fmt = msgfmt_parse_message('en_US', "{0,number,integer} monkeys on {1,number,integer} trees make {2,number} monkeys per tree",
                                "4,560 monkeys on 123 trees make 37.073 monkeys per tree");
    var_export($fmt);

    $fmt = msgfmt_parse_message('de', "{0,number,integer} Affen auf {1,number,integer} Bäumen sind {2,number} Affen pro Baum",
                                "4.560 Affen auf 123 Bäumen sind 37,073 Affen pro Baum");
    var_export($fmt);
    ?>

### OO example

    <?php
    $fmt = MessageFormatter::parseMessage('en_US', "{0,number,integer} monkeys on {1,number,integer} trees make {2,number} monkeys per tree",
                                "4,560 monkeys on 123 trees make 37.073 monkeys per tree");
    var_export($fmt);

    $fmt = MessageFormatter::parseMessage('de', "{0,number,integer} Affen auf {1,number,integer} Bäumen sind {2,number} Affen pro Baum",
                                "4.560 Affen auf 123 Bäumen sind 37,073 Affen pro Baum");
    var_export($fmt);
    ?>

&example.outputs;

    array (
      0 => 4560,
      1 => 123,
      2 => 37.073,
    )
    array (
      0 => 4560,
      1 => 123,
      2 => 37.073,
    )

&reftitle.seealso;

- `msgfmt_create`
- `msgfmt_format_message`
- `msgfmt_parse`