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 Take
23: {
24: /**
25: * Takes the first items with `$length`
26: * and returns them as a new collection.
27: *
28: * @param int<0, max> $length Number of items to take from the start
29: *
30: * @return CollectionInterface<TKey, T>
31: */
32: public function take(int $length): CollectionInterface;
33: }
34: