# Alpha(日本語)

`Zend_Filter_Alpha` は、 アルファベットを残して全てを削除した、文字列 `$value` を返すフィルターです。このフィルターには、空白文字を許すオプションもあります。 （訳注：ここでいうアルファベット、とはアラビア文字やタイ文字、キリール文字など、各言語で使われる文字の集合を意味します。英字とは限りません）

## Zend_Filter_Alpha でサポートされるオプション

下記のオプションが `Zend_Filter_Alpha` でサポートされます。

- allowwhitespace: このオプションが設定されていると、空白文字が許されます。 設定されていない場合は抑止されます。既定値では、空白文字は許されません。

## 基本的な使用法

下記は基本的な使用例です。

    $filter = new Zend_Filter_Alpha();

    print $filter->filter('This is (my) content: 123');

上記の例は 'Thisismycontent' を返します。 空白文字と括弧が削除されていることに注意してください。

`Zend_Filter_Alpha` はほとんどの言語で動作します。 しかしながら、３つの例外、中国語、日本語、Koreanがあります。 これらの言語では、英語のアルファベットが使用されます。 言語は `Zend_Locale` の使用を通じて検出されます。

## 空白文字を許す

`Zend_Filter_Alpha` は空白文字も許せます。 文字列から特別な文字を取り除きたい場合に役立つでしょう。 下記の例をご覧ください。

    $filter = new Zend_Filter_Alpha(array('allowwhitespace' => true));

    print $filter->filter('This is (my) content: 123');

上記の例は 'This is my content ' を返します。 括弧やコロン、数字が全て除去された一方で、空白文字が残っていることに注意してください。

メソッド初期化後に allowWhiteSpace を変更するには、 `setAllowWhiteSpace()` が使えるでしょう。

メソッドの現在の allowWhiteSpace の値を照会するには、 `getAllowWhiteSpace()` が使えるでしょう。