Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:111711
To: PHP internals <internals@lists.php.net>
Thread-Topic: Proposal: Adding functions any(iterable $input, ?callable $cb =
 null, int $use_flags=0) and all(...)
Thread-Index: AQHWfj2/bRooGr39CkeRSgZBGY4s+Q==
Date: Sat, 29 Aug 2020 20:24:45 +0000
Message-ID:
 <DM6PR07MB66188EBF51D1BED2560BC889F9530@DM6PR07MB6618.namprd07.prod.outlook.com>
Accept-Language: en-CA, en-US
Content-Language: en-CA
Content-Type: text/plain; charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg: 00000000-0000-0000-0000-000000000000
X-MS-Exchange-CrossTenant-Network-Message-Id: ebcd9d57-4cbd-480c-2911-08d84c5991f4
X-MS-Exchange-CrossTenant-rms-persistedconsumerorg: 00000000-0000-0000-0000-000000000000
X-MS-Exchange-CrossTenant-originalarrivaltime: 29 Aug 2020 20:24:45.7073
 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Internet
X-MS-Exchange-CrossTenant-id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa
X-MS-Exchange-Transport-CrossTenantHeadersStamped: CO1NAM04HT114
Subject: Proposal: Adding functions any(iterable $input, ?callable $cb = null,
 int $use_flags=0) and all(...)
From: tysonandre775@hotmail.com (tyson andre)

Hi internals,=0A=
=0A=
The primitives any() and all() are a common part of many programming langua=
ges and help in avoiding verbosity or unnecessary abstractions.=0A=
=0A=
- https://hackage.haskell.org/package/base-4.14.0.0/docs/Prelude.html#v:any=
=0A=
- https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_=
Objects/Array/some=0A=
- https://docs.python.org/3/library/functions.html#all=0A=
- https://docs.oracle.com/javase/8/docs/api/java/util/stream/Stream.html#al=
lMatch-java.util.function.Predicate-=0A=
=0A=
For example, the following code could be shortened significantly=0A=
=0A=
```=0A=
// Old version=0A=
$satisifes_predicate =3D false;=0A=
foreach ($items as $item) {=0A=
    if (API::satisfiesCondition($item)) {=0A=
        $satisfies_predicate =3D true;=0A=
        break;=0A=
    }=0A=
}=0A=
if (!$satisfies_predicate) {=0A=
    throw new APIException("No matches found");=0A=
}=0A=
=0A=
// New version is much shorter and readable=0A=
if (!any($items, fn($x) =3D> API::satisfiesCondition($x))) {=0A=
    throw new APIException("No matches found");=0A=
}=0A=
```=0A=
=0A=
That example doesn't have any suitable helpers already in the standard libr=
ary.=0A=
Using array_filter would unnecessarily call satisfiesCondition even after t=
he first item was found,=0A=
and array_search doesn't take a callback.=0A=
=0A=
A proposed implementation is https://github.com/php/php-src/pull/6053 - it =
takes similar flags and param orders to array_filter().=0A=
=0A=
Previous discussion was in https://externals.io/message/103357#103373=0A=
=0A=
- New contributors to projects wouldn't know about any() and all() if it wa=
s reimplemented with different semantics and only occasionally used=0A=
   (e.g. MyArrayUtil::any()) in various projects)=0A=
- If this was provided only in userland, there'd be low adoption and code s=
uch as the first example would remain common.=0A=
   If the standard library provided it, then polyfills would as well, makin=
g cleaner code easier to write.=0A=
=0A=
Thanks,=0A=
- Tyson=