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

    <para>
        <classname>Zend_Filter_Alnum</classname> は、
        アルファベットおよび数字だけを返すフィルターです。
        他の全ての文字は抑止されます。
        （訳注：ここでいうアルファベットおよび数字、とは各言語で使われる文字および数字の集合を意味します。英数字<emphasis>ではありません</emphasis>）
    </para>

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

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

        <itemizedlist>
            <listitem>
                <para>
                    <emphasis><property>allowwhitespace</property></emphasis>:
                    このオプションが設定されていると、空白文字が許されます。
                    設定されていない場合は抑止されます。既定値では、空白は許されません。
                </para>
            </listitem>
        </itemizedlist>
    </sect3>

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

        <para>
            このフィルターの既定の振る舞いについては、下記の例をご覧ください。
        </para>

        <programlisting language="php"><![CDATA[
$filter = new Zend_Filter_Alnum();
$return = $filter->filter('This is (my) content: 123');
// 'Thisismycontent123' を返します
]]></programlisting>

        <para>
            上記の例は 'Thisismycontent123' を返します。
            ご覧の通り、空白の全てと、括弧がフィルターされています。
        </para>

        <note>
            <para>
                <classname>Zend_Filter_Alnum</classname> はほとんどの言語で動作します。
                しかし実際には、３つの例外、中国語、日本語、Koreanがあります。
                これらの言語では、英語のアルファベットがそれらの言語の文字の替わりに使用されます。
                この言語自身は <classname>Zend_Locale</classname> を使って検出されます。
            </para>
        </note>
    </sect3>

    <sect3 id="zend.filter.set.alnum.whitespace">
        <title>空白を許す</title>

        <para>
            <classname>Zend_Filter_Alnum</classname> は空白も許します。
            テキストから特別な文字を取り除きたい場合に役立つでしょう。下記の例をご覧ください。
        </para>

        <programlisting language="php"><![CDATA[
$filter = new Zend_Filter_Alnum(array('allowwhitespace' => true));
$return = $filter->filter('This is (my) content: 123');
// 'This is my content 123' を返します。
]]></programlisting>

        <para>
            上記の例は 'This is my content 123' を返します。
            ご覧の通り、括弧はフィルターされましたが、空白には手が出されていません。
        </para>

        <para>
            あとで <property>allowWhiteSpace</property> を変更するには、
            <methodname>setAllowWhiteSpace()</methodname> や
            <methodname>getAllowWhiteSpace()</methodname> を使用できます。
        </para>
    </sect3>
</sect2>
<!--
vim:se ts=4 sw=4 et:
-->
