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 Slice
23: {
24: /**
25: * Takes a slice from a collection and returns it
26: * as a new collection.
27: *
28: * @param int<0, max> $start Start offset
29: * @param null|int<0, max> $length Length of collection (if not specified,
30: * all remaining values from the collection
31: * are used)
32: *
33: * @return CollectionInterface<TKey, T>
34: */
35: public function slice(int $start, ?int $length = null): CollectionInterface;
36: }
37: