<sect1 id="zend.measure.introduction">

    <title>הקדמה</title>

    <para>
        מחלקות ה <code>Zend_Measure_*</code> מספקות דרך כללית וקלה לעבודה עם מדידות.
        שימוש במחלקות ה <code>Zend_Measure_*</code>, מאפשר לך להפוך מדידות ליחידות שונות מאותו הסוג.
        הם יכולים להתווסף, להחסיר ולהשוואת אחד מול השני. מערך שהתקבל ממשתמש בשפה המקומית שלו, ניתן לקבל את יחידת המדידה המדוייקת. עשרות יחידות מדידה נתמכות.
    </para>

    <example id="zend.measure.introduction.example-1">
        <title>המרת מדידות</title>
        <para>
            הדוגמאות המקדימות הבאות מציגות כיצד ניתן להמיר יחידות מדידה אוטומטית. כדי להמיר מדידה, הערך שלו והסוג חייבים להיות ידועים מראש. הערך יכול להיות מסוג מספר שלם, עשרוני ואפילו סטרינג עם המספר המייצג אותו.
            המרות ניתן לבצע רק אם שני היחידות מאותו סוג, לא בין שני סוגים שונים.
        </para>
        <programlisting role="php"><![CDATA[
$locale = new Zend_Locale('en');
$unit = new Zend_Measure_Length(100, Zend_Measure_Length::METER, $locale);

// Convert meters to yards
echo $unit->convertTo(Zend_Measure_Length::YARD);
]]>
        </programlisting>
    </example>

    <para>
        <code>Zend_Measure_*</code> מכיל תמיכה בכמה יחידות מדידה שונות.
        כדי לקרוא לכל אחת מיחידות המדידה יש להשתמש בסוג ציון מסויים: <code>Zend_Measure_&lt;TYPE&gt;::NAME_OF_UNIT</code>, איפה זה &lt;TYPE&gt; מייצג ערך מספרי או פיזי ידוע.
        לכל יחידת מדידה יש גורם המרה ויחידת תצוגה. רשימה מלאה אודות יחידות התצוגה וההמרה ניתן לקרוא ב  <link linkend="zend.measure.types"><code>סוגי מדידה</code></link>.
    </para>

    <example id="zend.measure.introduction.example-2">
        <title>יחידת המדידה <code>meter</code></title>
        <para>
            יחידת המדידה <code>meter</code> נועדה למדידת מרחק, לכן הערך הקבוע שלה נתן למציאה במחלקת <code>Length</code>.
            כדי להשתמש בסוג מדידה זה, יש להשתמש בסוג הציון <code>Length::METER</code>. יחידת התצוגה של סוג מדידה זה היא <code>m</code>.
        </para>
        <programlisting role="php"><![CDATA[
echo Zend_Measure_Length::STANDARD;  // outputs 'Length::METER'
echo Zend_Measure_Length::KILOMETER; // outputs 'Length::KILOMETER'

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

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