<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<!-- EN-Revision: 24249 -->
<sect2 id="zend.filter.set.stringtolower">
    <title>StringToLower(日本語)</title>

    <para>
        Tこのフィルタは、入力を全て小文字に変換します。
    </para>

    <sect3 id="zend.filter.set.stringtolower.options">
        <title>Zend_Filter_StringToLower でサポートされるオプション</title>

        <para>
            <classname>Zend_Filter_StringToLower</classname> では、下記のオプションがサポートされます。
        </para>

        <itemizedlist>
            <listitem>
                <para>
                    <emphasis><property>encoding</property></emphasis>
                    使用されるべきエンコーディングを設定するためにこのオプションを使用します。
                </para>
            </listitem>
        </itemizedlist>
    </sect3>

    <sect3 id="zend.filter.set.stringtolower.basic">
        <title>基本的な使用法</title>

        <para>
            これは基本的な例です。
        </para>

        <programlisting language="php"><![CDATA[
$filter = new Zend_Filter_StringToLower();

print $filter->filter('SAMPLE');
// "sample" を返します
]]></programlisting>
    </sect3>

    <sect3 id="zend.filter.set.stringtolower.encoding">
        <title>Different encoded strings</title>

        <para>
            デフォルトでは、それはサーバの現時点のロケールで、文字を取り扱うだけです。
            他のcharset由来の文字は、無視されます。
            さらに、mbstring拡張が環境で利用できるとき、
            それらを小文字にすることもできます。
            <classname>StringToLower</classname>フィルタを初期化するときは、
            希望のエンコーディングを設定するだけです。
            または、後でエンコーディングを変更するために、
            <methodname>setEncoding()</methodname>メソッドを使います。
        </para>

        <programlisting language="php"><![CDATA[
// UTF-8 を使用
$filter = new Zend_Filter_StringToLower('UTF-8');

//または、構成を使うときに、役に立つことがありえる配列を与えます
$filter = new Zend_Filter_StringToLower(array('encoding' => 'UTF-8'));

//または後でこのようにします
$filter->setEncoding('ISO-8859-1');
]]></programlisting>

        <note>
            <title>間違ったエンコーディングの設定</title>

            <para>
                あるエンコーディングを設定したくて、mbstring拡張が環境で利用できないとき、
                例外を得ることに注意してください。
            </para>

            <para>
                また、mbstring拡張でサポートされないエンコーディングを設定しようとしているとき、
                例外を得ます。
            </para>
        </note>
    </sect3>
</sect2>
