PHPのarray_*関数の引数の順番はどれもめちゃめちゃなように見えるが何か法則性や意味はあるのか？

Question

夏休み期間限定イベントで「気になる」がたくさんついたのでちゃんと質問します。

PHPにはarray_*()（in_array()なども含め）の形の配列を扱う関数がたくさんありますよね。

しかし関数によって引数の順番に統一性がないように見え、PHPを触っている期間は長いものの全然覚えられず、相変わらずドキュメントを常に参照してしまいます。

例えば、array_filter()の引数は以下のようにフィルタする（処理対象の）配列を第一引数に入れますが、

array array_filter ( array $array [, callable $callback [, int $flag = 0 ]] )

一方in_array()では、検索したい値を第一引数に、検索対象の配列を第二引数に入れます。

bool in_array ( mixed $needle , array $haystack [, bool $strict = FALSE ] )

（書いてみてちょっと比較対象がよくないような気もしました・・・）

これはどうしてこういうぐちゃぐちゃなことになっているのでしょうか？ 何か法則性はあるのでしょうか？ それとも何も法則性はなくて、PHPによくある「歴史的な経緯」なのでしょうか？

（せめてPythonみたいにキーワード引数（somefunction(msg='message')）が使えるようになってくれればよいのですが）

参考

PHP: array_filter - Manual
http://php.net/manual/ja/function.array-filter.php

PHP: in_array - Manual
http://php.net/manual/ja/function.in-array.php

Answer 1

配列からの探索系（in_array、array_key_exists）と、可変個の配列を取る加減上コールバックを先に持ってくるほかないarray_mapを例外として、大半の関数はarrayを1つ目に取ります。

ただ、preg_matchやin_arrayでは検索パターンが第1引数なのに対して、strposやstrstrでは第2引数になるなど、こちらも引数の位置がバラバラです。

…極めつけには、implodeが「歴史的な理由により、引数をどちら の順番でも受けつけることが可能です。」とのことで、途中で変えたものすらあるようです。「まったく規則性の見えない関数群」は、もはやPHPのお家芸という感もあります。

Comments

[ikuwow]

ありがとうございます！ implode()はまさに歴史的な理由ですよね・・・。やっぱり規則性はないということで、わからなくなったら随時ドキュメントを見に行こうと思います。