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

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 12150 -->
<!-- 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 role="php"><![CDATA[
$locale = new Zend_Locale('de');
$machaine = "1.234.567,89 Meter";
$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 <code>getValue()</code>. <example
                id="zend.measure.output.value.example-1">
                <title>Récupération d'une valeur</title>

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

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

        <para>La méthode <code>getValue()</code> 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 <code>getType()</code> retourne l'unité de mesure courante. <example
                id="zend.measure.output.unit.example-1">
                <title>Récupérer l'unité de mesure</title>

                <programlisting role="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>