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

    <title>Erstellung einer Maßeinheit</title>

    <para>
        Bei der Erstellung einer Maßeinheit erwarten die <classname>Zend_Measure_*</classname> Methoden den
        Eingabe-/den Originalwert als ersten Parameter. Dieser kann ein
        <link linkend="zend.measure.creation.number"><code>nummerisches Argument</code>
        </link>
        , eine
        <link linkend="zend.measure.creation.string"><code>Zeichenkette</code>
        </link>
        ohne Einheit, oder eine
        <link linkend="zend.measure.creation.localized"><code>lokalisierte Zeichenkette</code>
        mit definierter Einheit</link> sein.
        Der zweite Parameter definiert die Art der Maßeinheit. Beide Parameter sind zwingend erforderlich. Die
        Sprache kann als optionaler dritter Parameter definiert werden.
    </para>

    <sect2 id="zend.measure.creation.number">

        <title>Eine Maßeinheit von einer Integer oder Floatzahl erstellen</title>

        <para>
            Zusätzlich zu Integerwerten können Floatwerte benutzt werden, aber
            <ulink url="http://www.php.net/float">"einfache Dezimalbrüche wie 0.1 or 0.7 können nicht in Ihre
            binäre Entsprechung konvertiert werden ohne den Verlust von Genauigkeit,"</ulink> was zeitweise
            zu erstaunlichen Ergebnissen führt. Genauso sollten zwei Floatzahlen nicht auf Gleichheit geprüft
            werden.
        </para>

        <example id="zend.measure.creation.number.example-1">
            <title>Erstellung einer Maßeinheit durch Integer oder Floatwerte</title>
            <programlisting role="php"><![CDATA[
$measurement = 1234.7;
$unit = new Zend_Measure_Length((integer)$measurement,
                                Zend_Measure_Length::STANDARD);
echo $unit;
// Ausgabe '1234 m' (Meter)

$unit = new Zend_Measure_Length($measurement, Zend_Measure_Length::STANDARD);
echo $unit;
// Ausgabe '1234.7 m' (Meter)
]]>
            </programlisting>
        </example>

    </sect2>

    <sect2 id="zend.measure.creation.string">

        <title>Erstellen einer Maßeinheit aus Zeichenketten</title>

        <para>
            Viele Maßeinheiten die als Eingabe einer ZF Anwendung empfangen werden können nur als
            Zeichenketten den Klassen von <classname>Zend_Measure_*</classname> übergeben werden, wie z.B. Zahlen die in
            <ulink url="http://en.wikipedia.org/wiki/Roman_numerals">Römischer Schreibweise</ulink> geschrieben
            werden, oder extrem lange Binärwerte die die Genauigkeit von PHP's natürlichen Integer und Floattypen
            übersteigen würden. Da Integer auch als Zeichenketten geschrieben werden können sollten, sobald
            die Gefahr eines Genauigkeitverlustes durch die Limits von PHP's Integer und Floatwerten besteht,
            stattdessen Zeichenketten verwendet werden. <classname>Zend_Measure_Number</classname> benutzt die
            BCMath Erweiterung um aussergewöhnliche Genauigkeit zu unterstützen, wie im gezeigen Beispiel,
            um die Beschränkungen von vielen PHP Funktionen wie
            <ulink url="http://php.net/bin2dec"><code>bin2dec()</code></ulink> zu umgehen.
        </para>

        <example id="zend.measure.creation.string.example-1">
            <title>Erstellung einer Maßeinheit durch Strings</title>
            <programlisting role="php"><![CDATA[
$mystring = "10010100111010111010100001011011101010001";
$unit = new Zend_Measure_Number($mystring, Zend_Measure_Number::BINARY);

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

        <para>
            Normalerweise kann <classname>Zend_Measure_*</classname> automatisch die gewünschte Maßeinheit aus einer
            gewöhnlichen Zeichenkette extrahieren. Nur die erste identifizierbare Zahl die Standard
            Europäisch/Lateinische Ziffern (0,1,2,3,4,5,6,7,8,9) benutzt wird für die Erstellung der Maßeinheit
            benutzt. Wenn weitere Zahlen in der Zeichenkette enthalten sind, werden diese Ignoriert.
        </para>

        <example id="zend.measure.creation.string.example-2">
            <title>Gewöhliche Texteingaben welche Maßeinheiten beinhalten</title>
            <programlisting role="php"><![CDATA[
$mystring = "Mein Haus ist 125m² groß";
$unit = new Zend_Measure_Area($mystring, Zend_Measure_Area::STANDARD);
echo $unit; // Ausgabe "125 m²";

$mystring = "Mein Haus ist 125m² groß, es hat 5 Räume mit jeweils 25m².";
$unit = new Zend_Measure_Area($mystring, Zend_Measure_Area::STANDARD);
echo $unit; // Ausgabe "125 m²";
]]>
            </programlisting>
        </example>

    </sect2>

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

        <title>Maßeinheiten von lokalisierten Zeichenketten</title>

        <para>
            Wenn eine Zeichenkette in lokalisierter Schreibweise eingegeben wurde, kann die richtige
            Interpretation nicht herausgefunden werden ohne das das gewünschte Gebietsschema bekannt ist.
            Die Teilung der Dezimalziffern mit "." und die Gruppierung der Tausender mit "," ist in der
            Englischen Sprache üblich, aber nur in anderen Sprachen. Um mit solchen Problemen umgehen zu können,
            besteht bei den lokalisierten Klassen der <classname>Zend_Measure_*</classname> Familie die Möglichkeit eine
            Sprache oder Region anzugeben, um einen Eingabewert eindeutig zu machen und die erwartete
            semantische Eingabe richtig zu interpretieren.
        </para>

        <example id="zend.measure.creation.localized.example-1">
            <title>Lokalisierte Zeichenketten</title>
            <programlisting role="php"><![CDATA[
$locale = new Zend_Locale('de');
$mystring = "Das Boot ist 1,234.50 lang.";
$unit = new Zend_Measure_Length($mystring,
                                Zend_Measure_Length::STANDARD,
                                $locale);
echo $unit; // Ausgabe "1.234 m"


$mystring = "Das Boot ist 1,234.50 lang.";
$unit = new Zend_Measure_Length($mystring,
                                Zend_Measure_Length::STANDARD,
                                'en_US');
echo $unit; // Ausgabe "1234.50 m"
]]>
            </programlisting>
        </example>

        <para>
            Seit Zend Framework 1.7.0 unterstützt <classname>Zend_Measure</classname> auch die Verwendung eines
            Anwendungsweiten Gebietsschemas. Man kann ganz einfach eine <classname>Zend_Locale</classname> Instanz
            in der Registry setzen wie anbei gezeigt. Mit dieser Schreibweise kann man das manuelle Setzen eines
            Gebietsschemas für jede Instanz vergessen wenn man das selbe Gebietsschema mehrere Male verwenden
            will.
        </para>

        <programlisting role="php"><![CDATA[
// In der Bootstrap Datei
$locale = new Zend_Locale('de_AT');
Zend_Registry::set('Zend_Locale', $locale);

// Irgendwo in der eigenen Anwendung
$length = new Zend_Measure_Length(Zend_Measure_Length::METER();
]]>
        </programlisting>

    </sect2>

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