repo_zf1/documentation/manual/fr/module_specs/Zend_Currency-Position.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect1 id="zend.currency.position">
    <title>Où est le symbole monnétaire?</title>

    <para>
        Le signe symbolique de la monnaie est positionné par rapport à sa valeur en fonction de
        la locale utilisée. Cependant, vous pouvez forcer ce positionnement grâce à l'option
        <property>display</property> qui se configure au moyen de constantes:
    </para>

    <table id="zend.currency.position.table-1">
        <title>Positions disponibles pour la monnaie</title>

        <tgroup cols="2" align="left">
            <thead>
                <row>
                    <entry>Constante</entry>
                    <entry>Description</entry>
                </row>
            </thead>

            <tbody>
                <row>
                    <entry><constant>STANDARD</constant></entry>
                    <entry>Affiche le symbole de la monnaie dans une position standard,
                    conforme à la locale</entry>
                </row>

                <row>
                    <entry><constant>RIGHT</constant></entry>

                    <entry>
                        Affiche le symbole de la monnaie à droite de sa valeur
                    </entry>
                </row>

                <row>
                    <entry><constant>LEFT</constant></entry>

                    <entry>
                        Affiche le symbole de la monnaie à gauche de sa valeur
                    </entry>
                </row>
            </tbody>
        </tgroup>
    </table>

    <example id="zend.currency.position.example-1">
        <title>Paramétrer la position du symbole monnétaire</title>

        <para>
            Imaginons que le client utilise la locale "en_US". Sans option, la valeur retournée
            serait par exemple:
        </para>

        <programlisting language="php"><![CDATA[
$currency = new Zend_Currency(
    array(
        'value' => 100,
    )
);

print $currency; // Retournerait '$ 100'
]]></programlisting>

        <para>
            En utilisant la valeur par défaut, le symbole pourrait être retourné à gauche ou à droite
            de la valeur de monnaie. Voyons comment fixer cette position:
        </para>

        <programlisting language="php"><![CDATA[
$currency = new Zend_Currency(
    array(
        'value'    => 100,
        'position' => Zend_Currency::RIGHT,
    )
);

print $currency; // Retournerait '100 $';
]]></programlisting>

        <para>
            Notez que dans le deuxième exemple, la position de <acronym>USD</acronym> est fixée
            quelle que soit la locale ou la monnaie considérée.
        </para>
    </example>
</sect1>