Files
doc-fr/reference/intl/messageformatter.xml
Sergey Panteleev b9b87d60ec Sync DOM, Intl and other docs to English (#152)
Co-authored-by: George Peter Banyard <girgias@php.net>
2022-01-13 12:01:05 +00:00

126 lines
4.7 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 4c2cddb29bd88492eff40c979fdf8f88c09e4ab2 Maintainer: dams Status: ready -->
<!-- Reviewed: yes -->
<phpdoc:classref xml:id="class.messageformatter" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>La classe MessageFormatter</title>
<titleabbrev>MessageFormatter</titleabbrev>
<partintro>
<!-- {{{ MessageFormatter intro -->
<section xml:id="messageformatter.intro">
&reftitle.intro;
<simpara>
<classname>MessageFormatter</classname> est une classe concrète qui permet
de produire des messages concaténés, et indépendants de la langue. La méthode
fournit dans cette classe sont utilisées pour construire des messages qui
sont destinés aux utilisateurs finaux.
</simpara>
<simpara>
La classe <classname>MessageFormatter</classname> assemble les messages à partir
de différents fragments (textes, nombres et dates), fournis par le programme.
Grace à la classe <classname>MessageFormatter</classname>, le programme
n'a pas besoin de connaître l'ordre des fragments. La classe utilise des
spécifications de formatage pour assembler les fragments en un seul message.
Par exemple, <classname>MessageFormatter</classname> vous permet d'afficher
la phrase <literal>"Fini d'imprimer x fichier sur y..."</literal> d'une
manière qui reste souple pour la traduction.
</simpara>
<simpara>
Avant, un message était créé sous forme de phrase, et géré comme une chaîne.
Cette procédure créait des problèmes pour les traductions, car la structure
de la phrase, l'ordre des mots, le format des nombres, etc. était très différents
d'une langue à l'autre. L'approche de création des messages,
indépendante de la langue, permet de séparer le message et les variables.
Avec ces variables, <classname>MessageFormatter</classname> peut concaténer
les différentes parties du message, les formater aux conventions correctes,
et fournir un message bien formé.
</simpara>
<simpara>
<classname>MessageFormatter</classname> prend une série d'objets, formate
les textes, et les insert dans les chaînes formatées dans les emplacements
corrects. Un grand choix de formats peut être utilisé en conjonction avec
<classname>MessageFormatter</classname> pour gérer le pluriel, les nombres,
etc. Typiquement, le message est fourni par une ressource, et les arguments
sont préparés dynamiquement.
</simpara>
</section>
<!-- }}} -->
<section xml:id="messageformatter.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<classsynopsis>
<ooclass>
<classname>MessageFormatter</classname>
</ooclass>
<classsynopsisinfo>
<ooclass>
<classname>MessageFormatter</classname>
</ooclass>
</classsynopsisinfo>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.messageformatter')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[not(@role='procedural')])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.messageformatter')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])">
<xi:fallback/>
</xi:include>
</classsynopsis>
<!-- }}} -->
</section>
<section xml:id="messageformatter.seealso">
&reftitle.seealso;
<para>
<simplelist>
<member>
<link xlink:href="&url.icu.formatparse;">
ICU formatting documentation
</link>
</member>
<member>
<link xlink:href="&url.icu.formatmsg;">
ICU message formatting description
</link>
</member>
<member>
<link xlink:href="&url.icu.msgformat;">ICU message formatters</link>
</member>
<member>
<link xlink:href="&url.icu.choiceformat;">ICU choice formatters</link>
</member>
</simplelist>
</para>
</section>
</partintro>
&reference.intl.entities.messageformatter;
</phpdoc:classref>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->