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

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

    <title>Einführung</title>

    <para>
        Die <classname>Zend_Measure_*</classname> Klassen bieten einen generischen und einfachen Weg um mit Maßeinheiten
        zu Arbeiten. Durch Verwendung der <classname>Zend_Measure_*</classname> Klassen können Maßeinheiten in verschiedene
        andere Maßeinheiten des gleichen Typs konvertiert werden. Diese können Addiert, Subtrahiert und miteinander
        verglichen werden. Von einer Eingabe in der Muttersprache eines Benutzers können die Einheiten der
        Maßeinheiten automatische extrahiert werden. Eine Vielzahl an Maßeinheiten wird unterstützt.
    </para>

    <example id="zend.measure.introduction.example-1">
        <title>Konvertieren von Maßeinheiten</title>
        <para>
            Das folgende einführende Beispiel zeigt die automatische Konvertierung von Einheiten von Maßeinheiten.
            Um eine Maßeinheit zu konvertieren muß dessen Wert und Typ bekannt sein. Der Wert kann ein Integer,
            ein Float oder sogar eine Zeichenkette sein die eine Zahl enthält. Konvertierungen sind nur für
            Einheiten des gleichen Typs möglich (Masse, Fläche, Temperatur, Beschleunigung, usw.), nicht zwischen
            verschiedenen Typen.
        </para>
        <programlisting role="php"><![CDATA[
$locale = new Zend_Locale('en');
$unit = new Zend_Measure_Length(100, Zend_Measure_Length::METER, $locale);

// Konvertiert Meter zu Yard
echo $unit->convertTo(Zend_Measure_Length::YARD);
]]></programlisting>
    </example>

    <para>
        <classname>Zend_Measure_*</classname> enthält Unterstützung für viele unterschiedliche Arten von Maßeinheiten. Die
        Arten der Maßeinheiten haben die folgende einheitliche Schreibweise:
        <classname>Zend_Measure_&lt;TYP&gt;::NAME_DER_EINHEIT</classname>, wobei &lt;TYP&gt; identisch ist mit einer
        bekannten physikalischen oder nummerischen Einheit. Jede Maßeinheit besteht aus einem Faktor für die
        Konvertierung und einer Darstellungseinheit. Eine detailierte Liste kann im Kapitel
        <link linkend="zend.measure.types"><code>Arten von Maßeinheiten</code></link> gefunden werden.
    </para>

    <example id="zend.measure.introduction.example-2">
        <title>Die Maßeinheit meter</title>
        <para>
            Der <code>meter</code> wird für das Abmessen von Längen verwendet und kann in der Klasse
            <code>Length</code> gefunden werden. Um auf diese Maßeinheit zu verweisen muß die Schreibweise
            <code>Length::METER</code> verwendet werden. Die Darstellungseinheit ist <code>m</code>.
        </para>
        <programlisting role="php"><![CDATA[
echo Zend_Measure_Length::STANDARD;  // Ausgabe 'Length::METER'
echo Zend_Measure_Length::KILOMETER; // Ausgabe 'Length::KILOMETER'

$unit = new Zend_Measure_Length(100,'METER');
echo $unit;
// Ausgabe '100 m'
]]></programlisting>
    </example>

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