関数・クラス解説
call_user_func_array
version:PHP 4 >= 4.0.4, PHP 5, PHP 7 (公式)パラメータの配列を指定してコールバック関数をコールする
公式リファレンス
書式
call_user_func_array ( callable $callback , array $param_arr ) : mixed
説明
param_arr にパラメータを指定して、 callback で指定したユーザー定義関数をコールします。
パラメータ
- callback
- コールするcallable。
- param_arr
- コールバック関数に渡すパラメータを指定する配列。
返値
コールバック関数の結果、あるいはエラー時に FALSE を返します。
注意
注意: PHP 5.4 より前のバージョンでは、 param_arr 内で参照される変数は、 関数に参照渡しされます。これは、 その関数がパラメータを参照渡しで受け取ることを期待しているかどうかにかかわらず同じです。 この形式でコール時に参照渡しをしても、廃止予定であるという notice は発生しません。とはいえ、それが廃止予定であることに変わりはなく、 PHP 5.4 では削除されました。 さらに、この形式は PHP の組み込み関数には適用できません。 組み込み関数については関数のシグネチャが優先されます。 参照渡しを期待しているところに値で渡すと警告が発生し、 call_user_func() は FALSE を返します (これには例外があります。参照カウンタが 1、つまりリテラルなどの場合です。 というのも、値を参照に変えても悪影響はなく、 値に書き込んでも何の効果もないからです。しかし、この例外に頼ってはいけません。 参照カウンタというのはあくまでも内部実装レベルの話であり、 今後もずっとそうであるとは限らないからです)。
注意: call_user_func() や call_user_func_array() で登録されたコールバックは、前のコールバックからスローされた例外がキャッチされていない場合はコールされません。
サンプル
例1 call_user_func_array() の例
function foobar($arg, $arg2) {
echo __FUNCTION__, " got $arg and $arg2\n";
}
class foo {
function bar($arg, $arg2) {
echo __METHOD__, " got $arg and $arg2\n";
}
}
// foobar() 関数に引数を 2 つ渡してコールします
call_user_func_array("foobar", array("one", "two"));
// $foo->bar() メソッドに引数を 2 つ渡してコールします
$foo = new foo;
call_user_func_array(array($foo, "bar"), array("three", "four"));
上の例の出力は、たとえば以下のようになります。
foobar got one and two
foo::bar got three and four
例2 call_user_func_array() での名前空間の使用法
namespace Foobar;
class Foo {
static public function test($name) {
print "Hello {$name}!\n";
}
}
// PHP 5.3.0 以降
call_user_func_array(__NAMESPACE__ .'\Foo::test', array('Hannes'));
// PHP 5.3.0 以降
call_user_func_array(array(__NAMESPACE__ .'\Foo', 'test'), array('Philip'));
上の例の出力は、たとえば以下のようになります。
Hello Hannes!
Hello Philip!
例3 ラムダ関数の使用
$func = function($arg1, $arg2) {
return $arg1 * $arg2;
};
var_dump(call_user_func_array($func, array(2, 4))); /* PHP 5.3.0 以降 */
上の例の出力は以下となります。
int(8)
例4 値の参照渡し
function mega(&$a){
$a = 55;
echo "function mega \$a=$a\n";
}
$bar = 77;
call_user_func_array('mega',array(&$bar));
echo "global \$bar=$bar\n";
上の例の出力は以下となります。
function mega $a=55
global $bar=55
参考
ワード検索
※入力キーワードが、関数名・説明文・タグに含まれるものを検索関数名アルファベット別
最終更新一覧
●stristr
大文字小文字を区別せず文字列を検索し、ヒット箇所以降(あるいは以前)の文字列を返却
●stripslashes
バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く
●stripos
大文字小文字を区別せずに文字列が最初に現れる位置を取得する
●stripcslashes
addcslashes() でクォートされた文字列をアンクォートする
●strip_tags
文字列から HTML と PHP のタグを除去して返却
●strcspn
指定した文字が最初に現れる位置を調べる
●strcoll
ロケールに基づいて2つの文字列を比較し同じか(あるいは大小)を判定する
●strcmp
2つの文字列を比較し同じか(あるいは大小)を判定する
●strchr
strstr() のエイリアス
●strcasecmp
2つの文字列を比較(大文字小文字を区別せず同じとみなす)
カテゴリー一覧
PHP の振る舞いの変更
音声フォーマットの操作
認証サービス
コマンドライン関連
圧縮およびアーカイブ
暗号
データベース関連
日付および時刻関連
ファイルシステム
自然言語および文字エンコーディング
画像処理および作成
メール関連
数学
テキスト以外の MIME 型
プロセス制御
その他の基本モジュール
その他のサービス
検索エンジン用の拡張モジュール
サーバー固有のモジュール
セッション関連
テキスト処理
変数・データ型関連
ウェブサービス
Windows 用のモジュール
XML 操作
GUI用の拡張モジュール