filter_data

(no version information, might be only in CVS)

filter_data -- 指定したフィルタでデータをフィルタリングする

説明

mixed filter_data ( mixed variable, int filter [, mixed filter_options [, string charset]] )

警告

この関数は、 実験的 なものです。この関数の動作・ 名前・その他ドキュメントに書かれている事項は、予告なく、将来的な PHP のリリースにおいて変更される可能性があります。 この関数は自己責任で使用してください。

パラメータ

variable

フィルタリングする値。配列の場合は再帰的に処理されます。

filter

使用するフィルタの ID。

filter_options

オプションあるいはフラグの論理和の連想配列。 オプションを指定可能なフィルタの場合、この配列の "flags" フィールドにフラグを指定します。 "callback" フィルタの場合は、callback 型を渡さなければなりません。

charset

フィルタリングに使用する文字セット。 現在は、このパラメータを使用するフィルタはありません。

返り値

フィルタリングされたデータ、あるいは処理に失敗した場合に NULL を返します。

例 1. filter_data() の例

<?php
var_dump
(filter_data('bob@example.com', FILTER_VALIDATE_EMAIL));
var_dump(filter_data('example.com', FILTER_VALIDATE_URL, FILTER_FLAG_SCHEME_REQUIRED));
?>

上の例の出力は以下となります。

string(15) "bob@example.com"
NULL

参考

input_get()
callback 型に関する情報