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

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

    <title>計測値の出力</title>

    <para>
        計測値は、さまざまな方法で出力することができます。
    </para>

    <para>
        <link linkend="zend.measure.output.auto"><code>自動的な出力</code>
        </link>
    </para>

    <para>
        <link linkend="zend.measure.output.value"><code>値の出力</code>
        </link>
    </para>

    <para>
        <link linkend="zend.measure.output.unit"><code>単位つきの出力</code>
        </link>
    </para>

    <para>
        <link linkend="zend.measure.output.unit"><code>ローカライズされた文字列での出力</code>
        </link>
    </para>

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

        <title>自動的な出力</title>

        <para>
            <classname>Zend_Measure</classname> は、文字列の自動的な出力をサポートしています。
            <example id="zend.measure.output.auto.example-1">
                <title>自動的な出力</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>計測値の出力</title>
            <para>
                出力を行うには、単に
                <ulink url="http://php.net/echo"><code>echo</code>
                </ulink>
                あるいは
                <ulink url="http://php.net/print"><code>print</code>
                </ulink>
                を使用するだけです。
            </para>
        </note>

    </sect2>

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

        <title>値の出力</title>

        <para>
            計測値の値だけを出力するには <code>getValue()</code> を使用します。
            <example id="zend.measure.output.value.example-1">
                <title>値の出力</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>
            <code>getValue()</code> メソッドには、オプションのパラメータ
            '<code>round</code>' を指定することができます。
            これは、出力結果の精度を設定するものです。標準の精度は
            '<code>2</code>' です。
        </para>
    </sect2>

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

        <title>単位つきの出力</title>

        <para>
            関数 <code>getType()</code> は、現在の単位を返します。
            <example id="zend.measure.output.unit.example-1">
                <title>単位の出力</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>ローカライズされた文字列での出力</title>

        <para>
            文字列を出力する際は、通常はユーザの国にあわせた書式にしたくなることでしょう。
            たとえば、"1234567.8" という値はドイツでは "1.234.567,8" と表します。
            この機能は、将来のリリースでサポートされる予定です。
        </para>

    </sect2>

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