forked from muglug/psl
-
Notifications
You must be signed in to change notification settings - Fork 1
/
split.php
57 lines (47 loc) · 1.5 KB
/
split.php
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
<?php
declare(strict_types=1);
namespace Psl\Str\Byte;
use Psl;
use Psl\Type;
use function explode;
/**
* Returns an array containing the string split on the given delimiter. The vec
* will not contain the delimiter itself.
*
* If the limit is provided, the array will only contain that many elements, where
* the last element is the remainder of the string.
*
* @throws Psl\Exception\InvariantViolationException If $limit is negative.
*
* @return list<string>
*
* @pure
*/
function split(string $string, string $delimiter, ?int $limit = null): array
{
if ('' === $delimiter) {
if (null === $limit || $limit >= length($string)) {
return chunk($string);
}
if (1 === $limit) {
return [$string];
}
Psl\invariant($limit > 1, 'Expected a non-negative limit.');
$result = chunk(slice($string, 0, $limit - 1));
$result[] = slice($string, $limit - 1);
return $result;
}
if (null === $limit) {
/** @var list<string>|false $result */
$result = explode($delimiter, $string);
} else {
/** @var list<string>|false $result */
$result = explode($delimiter, $string, $limit);
}
/**
* @psalm-suppress MissingThrowsDocblock - should not throw
* @psalm-suppress ImpureFunctionCall - see https://github.com/azjezz/psl/issues/130
* @psalm-suppress ImpureMethodCall - see https://github.com/azjezz/psl/issues/130
*/
return Type\vec(Type\string())->coerce($result);
}