Arrays: added wrap() method (#180)

Author: milo

src/Utils/Arrays.php

@@ -401,4 +401,19 @@ public static function toKey($value)
 	{
 		return key([$value => null]);
 	}
+
+
+	/**
+	 * Returns copy of the $array where every item is converted to string
+	 * and prefixed by $prefix and suffixed by $suffix.
+	 * @return string[]
+	 */
+	public static function wrap(array $array, string $prefix = '', string $suffix = ''): array
+	{
+		$res = [];
+		foreach ($array as $k => $v) {
+			$res[$k] = $prefix . $v . $suffix;
+		}
+		return $res;
+	}
 }

tests/Utils/Arrays.wrap().phpt

@@ -0,0 +1,46 @@
+<?php
+
+/**
+ * Test: Nette\Utils\Arrays::wrap()
+ */
+
+declare(strict_types=1);
+
+use Nette\Utils\Arrays;
+use Tester\Assert;
+
+
+require __DIR__ . '/../bootstrap.php';
+
+
+test('Basics', function () {
+	Assert::same([], Arrays::wrap([], '{', '}'));
+	Assert::same(['STR'], Arrays::wrap(['STR']));
+	Assert::same(['{STR'], Arrays::wrap(['STR'], '{'));
+	Assert::same(['STR}'], Arrays::wrap(['STR'], '', '}'));
+	Assert::same(['{STR}'], Arrays::wrap(['STR'], '{', '}'));
+});
+
+
+test('Type conversion', function () {
+	$o = new class {
+		public function __toString()
+		{
+			return 'toString';
+		}
+	};
+
+	$cases = [
+		[0, '0'],
+		[1.1, '1.1'],
+		[null, ''],
+		[false, ''],
+		[true, '1'],
+		[$o, 'toString'],
+	];
+	Assert::same(array_column($cases, 1), Arrays::wrap(array_column($cases, 0)));
+
+	Assert::error(function () {
+		Arrays::wrap([[]]);
+	}, E_NOTICE, 'Array to string conversion');
+});