repo_zf1/documentation/manual/fr/module_specs/Zend_Measure-Output.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 20827 -->
<!-- Reviewed: no -->
<sect1 id="zend.measure.output">
    <title>Récupérer des mesures</title>

    <para>Les mesures peuvent être récupérer de différentes manières.</para>

    <para>
        <link linkend="zend.measure.output.auto"><code>Récupération automatique</code>
        </link>
    </para>

    <para>
        <link linkend="zend.measure.output.value"><code>Récupération des valeurs</code>
        </link>
    </para>

    <para>
        <link linkend="zend.measure.output.unit"><code>Récupération de l'unité de
        mesure</code> </link>
    </para>

    <para>
        <link linkend="zend.measure.output.unit"><code>Récupération en tant que chaîne
        régionale</code> </link>
    </para>

    <sect2 id="zend.measure.output.auto">
        <title>Récupération automatique</title>

        <para>
            <classname>Zend_Measure</classname> supporte la récupération sous formes de
            chaînes de caractères automatiquement. <example id="zend.measure.output.auto.example-1">
                    <title>Récupération automatique</title>

                    <programlisting language="php"><![CDATA[
$locale = new Zend_Locale('de');
$machaine = "1.234.567,89";
$unite = new Zend_Measure_Length($machaine,
                                 Zend_Measure_Length::STANDARD,
                                 $locale);

echo $unite; // affiche "1234567.89 m"
]]></programlisting>
                </example>
            </para>

        <note>
            <title>Affichage de la mesure</title>

            <para>
                L'affichage peut être réalisé simplement en utilisant <ulink
                url="http://php.net/echo"><code>echo</code></ulink> ou <ulink
                url="http://php.net/print"><code>print</code></ulink>.
            </para>
        </note>
    </sect2>

    <sect2 id="zend.measure.output.value">
        <title>Récupération des valeurs</title>

        <para>
            La valeur d'une mesure peut être récupérée en utilisant <methodname>getValue()</methodname>.
            <example id="zend.measure.output.value.example-1">
                    <title>Récupération d'une valeur</title>

                    <programlisting language="php"><![CDATA[
$locale = new Zend_Locale('de');
$machaine = "1.234.567,89";
$unite = new Zend_Measure_Length($machaine,
                                 Zend_Measure_Length::STANDARD,
                                 $locale);

echo $unite->getValue(); // affiche "1234567.89"
]]></programlisting>
                </example>
            </para>

        <para>
            La méthode <methodname>getValue()</methodname> accepte un paramètre facultatif
            "<code>round</code>" qui permet de définir la précision de la sortie générée. La
            précision par défaut est de <code>2</code>.
        </para>
    </sect2>

    <sect2 id="zend.measure.output.unit">
        <title>Récupération de l'unité de mesure</title>

        <para>
            La fonction <methodname>getType()</methodname> retourne l'unité de mesure courante. <example
                    id="zend.measure.output.unit.example-1">
                    <title>Récupérer l'unité de mesure</title>

                    <programlisting language="php"><![CDATA[
$locale = new Zend_Locale('de');
$machaine = "1.234.567,89";
$unit = new Zend_Measure_Weight($machaine,
                                Zend_Measure_Weight::POUND,
                                $locale);

echo $unit->getType(); // affiche "POUND"
]]></programlisting>
                </example>
            </para>
    </sect2>

    <sect2 id="zend.measure.output.localized">
        <title>Récupération en tant que chaîne régionale</title>

        <para>
            Récupérer une chaîne dans un format habituel du pays de l'utilisateur est
            habituellement souhaitable. Par exemple, la mesure "1234567.8" deviendrait "1.234.567,8"
            pour l'Allemagne. Cette fonctionnalité sera supportée dans une future version.
        </para>
    </sect2>
</sect1>