PHP Conference Nagoya 2025

    MessageFormatter::setPattern

    msgfmt_set_pattern

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

    MessageFormatter::setPattern -- msgfmt_set_pattern — Define o modelo usado pelo formatador

    Descrição

    Estilo orientado a objetos

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

    Estilo procedural

    msgfmt_set_pattern(MessageFormatter $formatter, string $pattern): bool

    Define o modelo a ser usado pelo formatador.

    Parâmetros

    formatter

    O formatador de mensagem

    pattern

    A string com o modelo a ser usado no formatador. O modelo usa uma sintaxe adequada para tratar apóstrofos/aspas; consulte » Aspas/Escape para detalhes.

    Valor Retornado

    Retorna true em caso de sucesso ou false em caso de falha.

    Exemplos

    Exemplo #1 Exemplo de msgfmt_set_pattern()

    <?php
    $fmt     = msgfmt_create( "en_US", "{0, number} monkeys on {1, number} trees" );
    echo     "Modelo atual: '" . msgfmt_get_pattern( $fmt ) . "'\n";
    echo     "Resultado da formatação: " . msgfmt_format( $fmt, array(123, 456) ) . "\n";

    msgfmt_set_pattern( $fmt, "{0, number} trees hosting {1, number} monkeys" );
    echo     "Novo modelo: '" . msgfmt_get_pattern( $fmt ) . "'\n";
    echo     "Número formatado: " . msgfmt_format( $fmt, array(123, 456) ) . "\n";
    ?>

    Exemplo #2 OO example

    <?php
    $fmt     = new MessageFormatter( "en_US", "{0, number} monkeys on {1, number} trees" );
    echo     "Modelo atual: '" . $fmt->getPattern() . "'\n";
    echo     "Resultado da formatação: " . $fmt->format(array(123, 456)) . "\n";

    $fmt->setPattern("{0, number} trees hosting {1, number} monkeys" );
    echo     "Novo modelo: '" . $fmt->getPattern() . "'\n";
    echo     "Número formatado: " . $fmt->format(array(123, 456)) . "\n";
    ?>

    O exemplo acima produzirá:

    Modelo atual: '{0,number} monkeys on {1,number} trees'
Resultado da formatação: 123 monkeys on 456 trees
Novo modelo: '{0,number} trees hosting {1,number} monkeys'
Número formatado: 123 trees hosting 456 monkeys

    Veja Também

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicione uma nota

    Notas Enviadas por Usuários (em inglês) 1 note

    up
    0
    neil dot smith at vouchercloud dot com
    10 years ago
    A correct example would be to transpose the placeholders in pattern 2.

    This is typical where changing messages from one language to another changes the word order, to result in a sensible translation.

    Let's imagine it's localised as Spanish or Russian instead of English.
    So really you want to have pattern 2 provided by your human translator to read like this :

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

    That is - the order of arguments is always the same, but your translated message content has the placeholders transposed for non English languages.
    ＋adicione uma nota
    To Top