Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:72342
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.212.42 as permitted sender)
MIME-Version: 1.0
Date: Thu, 6 Feb 2014 22:38:51 +0800
Message-ID: <CAHMUw2EkBEFnb_Qs1y6xS8AEr6dO48wSAqSWr55W3fRMuumT5Q@mail.gmail.com>
To: PHP Internals <internals@lists.php.net>
Content-Type: multipart/alternative; boundary=089e0122f1cafbdd9504f1bdd443
Subject: [discussion] add array_usearch()
From: tjerk.meesters@gmail.com (Tjerk Meesters)

--089e0122f1cafbdd9504f1bdd443
Content-Type: text/plain; charset=ISO-8859-1

Hi internals,

To complement array_search(), I'm gauging the interest in adding the
following function:

mixed array_usearch(array $haystack, callable $fn, int $flags = 0)

It returns the first array key from a given haystack for which the callback
function returns a truthy value [1] or `false` otherwise. The callback
function receives the array item as its only argument [2].

The flags, described below, can be combined by using a binary or.

[1] the interpretation of the return value can be inverted by using
`ARRAY_USEARCH_INVERT`
[2] the array key is passed as the 2nd argument by using
`ARRAY_USEARCH_USE_KEY`

An implementation of array_all() and array_some(), which you may find in
ECMAScript:

 function array_some(array $array, $fn)
 {
   return array_usearch($array, $fn) !== false;
 }

 function array_all(array $array, $fn)
 {
   return array_usearch($array, $fn, ARRAY_USEARCH_INVERT) === false;
 }

Another example:

 echo array_usearch(['a', 'b', 2], 'is_numeric'); // 2

The implementation can be found here:
https://github.com/datibbaw/php-src/compare/master...array-usearch

Let me know your thoughts.


-- 
--
Tjerk

--089e0122f1cafbdd9504f1bdd443--