Edit Report a Bug

    MessageFormatter::formatMessage

    msgfmt_format_message

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

    MessageFormatter::formatMessage -- msgfmt_format_message — Quick format message

    Descrierea

    Stil obiect-orientat

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

    Stil procedural

    msgfmt_format_message ( string $locale , string $pattern , array $args ) : string

    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.

    Parametri

    locale

    The locale to use for formatting locale-dependent parts

    pattern

    The pattern string to insert things into. The pattern uses an 'apostrophe-friendly' syntax; it is run through » umsg_autoQuoteApostrophe before being interpreted.

    args

    The array of values to insert into the format string

    Valorile întoarse

    The formatted pattern string or false if an error occurred

    Exemple

    Example #1 msgfmt_format_message() example

    <?php
    echo msgfmt_format_message("en_US", "{0,number,integer} monkeys on {1,number,integer} trees make {2,number} monkeys per tree\n", array(4560, 123, 4560/123));
    echo     msgfmt_format_message("de", "{0,number,integer} Affen auf {1,number,integer} Bäumen sind {2,number} Affen pro Baum\n", 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\n", array(4560, 123, 4560/123));
    echo     MessageFormatter::formatMessage("de", "{0,number,integer} Affen auf {1,number,integer} Bäumen sind {2,number} Affen pro Baum\n", array(4560, 123, 4560/123));
    ?>

    Exemplul de mai sus va afișa:

    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

    A se vedea și

    add a note add a note

    User Contributed Notes 3 notes

    up
    5
    zlobnygrif at gmail dot com
    11 years ago
    <?php
    var_dump    (
          msgfmt_format_message('ru_RU', 'The value of {somekey} is {0, choice, 0 #less 12| 12 #between 12 and 32| 32 #more than 32}', ['SomeAnotherKey' => -1]),
          msgfmt_format_message('ru_RU', 'The value of {somekey} is {0, choice, 0 #less 12| 12 #between 12 and 32| 32 #more than 32}', [14]),
          msgfmt_format_message('ru_RU', 'The value of {somekey} is {0, choice, 0 #less 12| 12 #between 12 and 32| 32 #more than 32}', [133]),
          msgfmt_format_message('ru_RU', '{0, plural, =0{Zero}=1{One}other{Unknown #}}', [0]),
          msgfmt_format_message('ru_RU', '{0, plural, =0{Zero}=1{One}other{Unknown #}}', [1]),
          msgfmt_format_message('ru_RU', '{0, plural, =0{Zero}=1{One}other{Unknown #}}', [2]),
          msgfmt_format_message('ru_RU', '{0, select, somevalue{This is some value} other{Unknown value}}', ['somevalue']),
          msgfmt_format_message('ru_RU', '{0, select, somevalue{This is some value} other{Unknown value "{0}"}}', ['somevalue2'])
    );

    var_dump(
          msgfmt_format_message('en_GB', 'Peter has {0, plural, =0{no cat} =1{a cat} other{# cats}}', [0]),
          msgfmt_format_message('en_GB', 'Peter has {0, plural, =0{no cat} =1{a cat} other{# cats}}', [1]),
          msgfmt_format_message('en_GB', 'Peter has {0, plural, =0{no cat} =1{a cat} other{# cats}}', [2])
    );
    ?>

    Output (PHP 5.4.17RC1)
    ==========================
    string 'The value of -1 is less 12' (length=26)
    string 'The value of 14 is between 12 and 32' (length=36)
    string 'The value of 133 is more than 32' (length=32)
    string 'Zero' (length=4)
    string 'One' (length=3)
    string 'Unknown 2' (length=9)
    string 'This is some value' (length=18)
    string 'Unknown value "somevalue2"' (length=26)
    string 'Peter has no cat' (length=16)
    string 'Peter has a cat' (length=15)
    string 'Peter has 2 cats' (length=16)
    up
    2
    ricardoyubal at gmail dot com
    3 years ago
    Although not mentioned, single quotes (') are used internally as escaping characters. So if you want to have them in your output, you should escape them with another single quote. See examples below.

    <?php

    // The value {foo} should be enclosed in single quotes
    echo msgfmt_format_message('en_US', "The value '{foo}' should be enclosed in single quotes", ['foo' => 'bar']);

    // The value 'bar' should be enclosed in single quotes
    echo msgfmt_format_message('en_US', "The value ''{foo}'' should be enclosed in single quotes", ['foo' => 'bar']);

    ?>
    up
    1
    contact at sowapps dot com
    3 years ago
    For now, there is now way to define a default value.

    <?php
    echo msgfmt_format_message('fr_FR', '{distance, plural, =0{Here}other{# km}}', []);
    // Show {distance}
    ?>
    add a note add a note
    To Top