# MessageFormatter::format

# msgfmt_format

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

MessageFormatter::format -- msgfmt_format — Formate un message

### Description

Style orienté objet

public MessageFormatter::format(array `$values`): string|false

Style procédural

msgfmt_format(MessageFormatter `$formatter`, array `$values`): string|false

Formate un message en substituant les données dans la chaînes de modèle, en fonction des conventions locales.

### Liste de paramètres

`formatter`

  Un objet de formateur de messages MessageFormatter

`values`

  Les arguments à insérer dans les chaînes

### Valeurs de retour

La chaîne formatée, `false` si une erreur survient.

### Exemples

Exemple #1 Exemple avec msgfmt_format(), style procédural

`<?php
$fmt = msgfmt_create("en_US", "{0,number,integer} singes sur {1,number,integer} arbres font {2,number} singes par arbre");
echo msgfmt_format($fmt, array(4560, 123, 4560/123));
$fmt = msgfmt_create("de", "{0,number,integer} Affen über {1,number,integer} Bäume um {2,number} Affen pro Baum");
echo msgfmt_format($fmt, array(4560, 123, 4560/123));
?>`

Exemple #2 Exemple avec msgfmt_format(), style POO

`<?php
$fmt = new MessageFormatter("en_US", "{0,number,integer} singes sur {1,number,integer} arbres font {2,number} singes par arbre");
echo $fmt->format(array(4560, 123, 4560/123));
$fmt = new MessageFormatter("de", "{0,number,integer} Affen über {1,number,integer} Bäume um {2,number} Affen pro Baum");
echo $fmt->format(array(4560, 123, 4560/123));
?>`

L'exemple ci-dessus va afficher :

    4,560 singes sur 123 arbres font 37.073 singes par arbre
    4.560 Affen über 123 Bäume um 37,073 Affen pro Baum

### Voir aussi

- msgfmt_create() - Construit un nouveau formateur de messages
- msgfmt_parse() - Analyse une chaîne en fonction du modèle
- msgfmt_format_message() - Formate rapidement un message
- msgfmt_get_error_code() - Lit le dernier code d'erreur de la dernière opération
- msgfmt_get_error_message() - Lit le message d'erreur de la dernière opération