Strings::split() added parameter $limit

Author: dg

src/Utils/Strings.php

@@ -489,11 +489,12 @@ public static function split(
 		string $pattern,
 		bool|int $captureOffset = false,
 		bool $skipEmpty = false,
+		int $limit = -1,
 	): array {
 		$flags = is_int($captureOffset) && $captureOffset // back compatibility
 			? $captureOffset
 			: ($captureOffset ? PREG_SPLIT_OFFSET_CAPTURE : 0) | ($skipEmpty ? PREG_SPLIT_NO_EMPTY : 0);
-		return self::pcre('preg_split', [$pattern, $subject, -1, $flags | PREG_SPLIT_DELIM_CAPTURE]);
+		return self::pcre('preg_split', [$pattern, $subject, $limit, $flags | PREG_SPLIT_DELIM_CAPTURE]);
 	}
 
 

tests/Utils/Strings.split().phpt

@@ -52,3 +52,5 @@ Assert::same([
 	[',', 4],
 	['c', 6],
 ], Strings::split('a, b, c', '#(,)\s*#', captureOffset: true));
+
+Assert::same(['a', ',', 'b, c'], Strings::split('a, b, c', '#(,)\s*#', limit: 2));