Strings::replace() added parameters $captureOffset, $unmatchedAsNull

Author: dg

src/Utils/Strings.php

@@ -517,12 +517,15 @@ public static function replace(
 		string|array $pattern,
 		string|callable $replacement = '',
 		int $limit = -1,
+		bool $captureOffset = false,
+		bool $unmatchedAsNull = false,
 	): string {
 		if (is_object($replacement) || is_array($replacement)) {
 			if (!is_callable($replacement, false, $textual)) {
 				throw new Nette\InvalidStateException("Callback '$textual' is not callable.");
 			}
-			return self::pcre('preg_replace_callback', [$pattern, $replacement, $subject, $limit]);
+			$flags = ($captureOffset ? PREG_OFFSET_CAPTURE : 0) | ($unmatchedAsNull ? PREG_UNMATCHED_AS_NULL : 0); 
+			return self::pcre('preg_replace_callback', [$pattern, $replacement, $subject, $limit, 0, $flags]);
 
 		} elseif (is_array($pattern) && is_string(key($pattern))) {
 			$replacement = array_values($pattern);

tests/Utils/Strings.replace().phpt

@@ -34,3 +34,5 @@ Assert::same('#@ @@@#d!', Strings::replace('hello world!', [
 ]));
 Assert::same(' !', Strings::replace('hello world!', '#\w#'));
 Assert::same(' !', Strings::replace('hello world!', ['#\w#']));
+Assert::same('hell0o worl9d!', Strings::replace('hello world!', '#[e-l]+#', fn($m) => implode($m[0]), captureOffset: true));
+Strings::replace('hello world!', '#e(x)*#', fn($m) => Assert::null($m[1]), unmatchedAsNull: true);