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

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

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

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

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

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

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

    <para>
        <link linkend="zend.measure.output.unit">ローカライズされた文字列での出力</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 language="php"><![CDATA[
$locale = new Zend_Locale('de');
$mystring = "1.234.567,89";
$unit = new Zend_Measure_Length($mystring,
                                Zend_Measure_Length::STANDARD,
                                $locale);

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

        <note>
            <title>計測値の出力</title>
            <para>
                出力を行うには、単に
                <ulink url="http://www.php.net/manual/ja/function.echo.php">echo</ulink>
                あるいは
                <ulink url="http://www.php.net/manual/ja/function.print.php">print</ulink>
                を使用するだけです。
            </para>
        </note>

    </sect2>

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

        <title>値の出力</title>

        <para>
            計測値の値だけを出力するには <methodname>getValue()</methodname> を使用します。
            <example id="zend.measure.output.value.example-1">
                <title>値の出力</title>
                <programlisting language="php"><![CDATA[
$locale = new Zend_Locale('de');
$mystring = "1.234.567,89";
$unit = new Zend_Measure_Length($mystring,
                                Zend_Measure_Length::STANDARD,
                                $locale);

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

        <para>
            <methodname>getValue()</methodname> メソッドには、オプションのパラメータ
            <property>round</property> を指定できます。
            これは、出力結果の精度を設定するものです。標準の精度は '2' です。
        </para>
    </sect2>

    <sect2 id="zend.measure.output.unit">
        <title>単位つきの出力</title>

        <para>
            関数 <methodname>getType()</methodname> は、現在の単位を返します。
            <example id="zend.measure.output.unit.example-1">
                <title>単位の出力</title>
                <programlisting language="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:
-->