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

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 15157 -->
<!-- Reviewed: no -->
<sect1 id="zend.measure.output">

    <title>Ausgabe von Maßeinheiten</title>

    <para>
        Maßeinheiten können auf verschiedenen Wegen als Zahl ausgegeben werden.
    </para>

    <para>
        <link linkend="zend.measure.output.auto"><code>Automatische Ausgabe</code>
        </link>
    </para>

    <para>
        <link linkend="zend.measure.output.value"><code>Ausgabe als Wert</code>
        </link>
    </para>

    <para>
        <link linkend="zend.measure.output.unit"><code>Ausgabe mit einer Maßeinheit</code>
        </link>
    </para>

    <para>
        <link linkend="zend.measure.output.unit"><code>Ausgabe als lokalisierte Zeichenkette</code>
        </link>
    </para>

    <sect2 id="zend.measure.output.auto">

        <title>Automatische Ausgabe</title>

        <para>
            <classname>Zend_Measure</classname> unterstützt die automatische Ausgabe von Zeichenketten.
            <example id="zend.measure.output.auto.example-1">
                <title>Automatische Ausgabe</title>
                <programlisting role="php"><![CDATA[
$locale = new Zend_Locale('de');
$mystring = "1.234.567,89 Meter";
$unit = new Zend_Measure_Length($mystring,
                                Zend_Measure_Length::STANDARD,
                                $locale);

echo $unit;
]]></programlisting>
            </example>
        </para>

        <note>
            <title>Ausgabe der Maßeinheit</title>
            <para>
                Die Ausgabe kann einfach erzielt werden durch Verwendung von
                <ulink url="http://php.net/echo"><code>echo</code></ulink> oder
                <ulink url="http://php.net/print"><code>print</code></ulink>.
            </para>
        </note>

    </sect2>

    <sect2 id="zend.measure.output.value">

        <title>Ausgabe als Wert</title>

        <para>
            Der Wert einer Maßeinheit kann mit <code>getValue()</code> ausgegeben werden.
            <example id="zend.measure.output.value.example-1">
                <title>Ausgabe eines Wertes</title>
                <programlisting role="php"><![CDATA[
$locale = new Zend_Locale('de');
$mystring = "1.234.567,89 Meter";
$unit = new Zend_Measure_Length($mystring,
                                Zend_Measure_Length::STANDARD,
                                $locale);

echo $unit->getValue();
]]></programlisting>
            </example>
        </para>

        <para>
            Die <code>getValue()</code> Methode akzeptiert einen optionalen Parameter '<code>round</code>'
            der es erlaubt eine Genauigkeit für die erstellte Ausgabe zu definieren. Die Standardgenauigkeit ist
            '<code>2</code>'.
        </para>
    </sect2>

    <sect2 id="zend.measure.output.unit">

        <title>Ausgabe mit einer Maßeinheit</title>

        <para>
            Die Funktion <code>getType()</code> gibt die aktuelle Maßeinheit zurück.
            <example id="zend.measure.output.unit.example-1">
                <title>Outputting units</title>
                <programlisting role="php"><![CDATA[
$locale = new Zend_Locale('de');
$mystring = "1.234.567,89";
$unit = new Zend_Measure_Weight($mystring,
                                Zend_Measure_Weight::POUND,
                                $locale);

echo $unit->getType();
]]></programlisting>
            </example>
        </para>

    </sect2>

    <sect2 id="zend.measure.output.localized">

        <title>Ausgabe als lokalisierte Zeichenkette</title>

        <para>
            Die Ausgabe einer Zeichenkette in einem Format welches in dem Land des Benutzers üblich ist, ist
            normalerweise gewünscht Die Maßeinheit "1234567.8" würde im Deutschen zum Beispiel zu
            "1.234.567,8" werden. Diese Funktionalität wird in einem zukünftigen Release unterstützt.
        </para>

    </sect2>

</sect1>
<!--
vim:se ts=4 sw=4 et:
-->