1: | <?php |
2: | |
3: | declare(strict_types=1); |
4: | |
5: | /** |
6: | * This file is part of the Nexus framework. |
7: | * |
8: | * (c) John Paul E. Balandan, CPA <paulbalandan@gmail.com> |
9: | * |
10: | * For the full copyright and license information, please view |
11: | * the LICENSE file that was distributed with this source code. |
12: | */ |
13: | |
14: | namespace Nexus\Collection\Operation; |
15: | |
16: | use Nexus\Collection\CollectionInterface; |
17: | |
18: | /** |
19: | * @template TKey |
20: | * @template T |
21: | */ |
22: | interface Partition |
23: | { |
24: | /** |
25: | * Partition the collection into 2 tuples of collections. |
26: | * |
27: | * The first inner collection consists of items that have passed the `$predicate`. |
28: | * The last inner collection consists of items that have failed the `$predicate`. |
29: | * |
30: | * @param (\Closure(T, TKey): bool) $predicate |
31: | * |
32: | * @return CollectionInterface<int, CollectionInterface<TKey, T>> |
33: | */ |
34: | public function partition(\Closure $predicate): CollectionInterface; |
35: | } |
36: |