added Arrays::every(), some() & map() [Closes #36]

Author: dg

src/Utils/Arrays.php

@@ -250,4 +250,48 @@ public static function pick(array & $arr, $key, $default = NULL)
 		}
 	}
 
+
+	/**
+	 * Tests whether some element in the array passes the callback test.
+	 * @return bool
+	 */
+	public static function some(array $arr, callable $callback)
+	{
+		foreach ($arr as $k => $v) {
+			if ($callback($v, $k, $arr)) {
+				return TRUE;
+			}
+		}
+		return FALSE;
+	}
+
+
+	/**
+	 * Tests whether all elements in the array pass the callback test.
+	 * @return bool
+	 */
+	public static function every(array $arr, callable $callback)
+	{
+		foreach ($arr as $k => $v) {
+			if (!$callback($v, $k, $arr)) {
+				return FALSE;
+			}
+		}
+		return TRUE;
+	}
+
+
+	/**
+	 * Applies the callback to the elements of the array.
+	 * @return array
+	 */
+	public static function map(array $arr, callable $callback)
+	{
+		$res = [];
+		foreach ($arr as $k => $v) {
+			$res[$k] = $callback($v, $k, $arr);
+		}
+		return $res;
+	}
+
 }

tests/Utils/Arrays.every().phpt

@@ -0,0 +1,78 @@
+<?php
+
+/**
+ * Test: Nette\Utils\Arrays::every()
+ */
+
+use Nette\Utils\Arrays;
+use Tester\Assert;
+
+
+require __DIR__ . '/../bootstrap.php';
+
+
+test(function () {
+	$arr = [];
+	$log = [];
+	$res = Arrays::every(
+		$arr,
+		function ($v, $k, $arr) use (& $log) { $log[] = func_get_args(); return FALSE; }
+	);
+	Assert::true($res);
+	Assert::same([], $log);
+});
+
+test(function () {
+	$arr = [];
+	$log = [];
+	$res = Arrays::every(
+		$arr,
+		function ($v, $k, $arr) use (& $log) { $log[] = func_get_args(); return TRUE; }
+	);
+	Assert::true($res);
+	Assert::same([], $log);
+});
+
+test(function () {
+	$arr = ['a', 'b'];
+	$log = [];
+	$res = Arrays::every(
+		$arr,
+		function ($v, $k, $arr) use (& $log) { $log[] = func_get_args(); return FALSE; }
+	);
+	Assert::false($res);
+	Assert::same([['a', 0, $arr]], $log);
+});
+
+test(function () {
+	$arr = ['a', 'b'];
+	$log = [];
+	$res = Arrays::every(
+		$arr,
+		function ($v, $k, $arr) use (& $log) { $log[] = func_get_args(); return TRUE; }
+	);
+	Assert::true($res);
+	Assert::same([['a', 0, $arr], ['b', 1, $arr]], $log);
+});
+
+test(function () {
+	$arr = ['a', 'b'];
+	$log = [];
+	$res = Arrays::every(
+		$arr,
+		function ($v, $k, $arr) use (& $log) { $log[] = func_get_args(); return $v === 'a'; }
+	);
+	Assert::false($res);
+	Assert::same([['a', 0, $arr], ['b', 1, $arr]], $log);
+});
+
+test(function () {
+	$arr = ['x' => 'a', 'y' => 'b'];
+	$log = [];
+	$res = Arrays::every(
+		$arr,
+		function ($v, $k, $arr) use (& $log) { $log[] = func_get_args(); return TRUE; }
+	);
+	Assert::true($res);
+	Assert::same([['a', 'x', $arr], ['b', 'y', $arr]], $log);
+});

tests/Utils/Arrays.map().phpt

@@ -0,0 +1,45 @@
+<?php
+
+/**
+ * Test: Nette\Utils\Arrays::map()
+ */
+
+use Nette\Utils\Arrays;
+use Tester\Assert;
+
+
+require __DIR__ . '/../bootstrap.php';
+
+
+test(function () {
+	$arr = [];
+	$log = [];
+	$res = Arrays::map(
+		$arr,
+		function ($v, $k, $arr) use (& $log) { $log[] = func_get_args(); return TRUE; }
+	);
+	Assert::same([], $res);
+	Assert::same([], $log);
+});
+
+test(function () {
+	$arr = ['a', 'b'];
+	$log = [];
+	$res = Arrays::map(
+		$arr,
+		function ($v, $k, $arr) use (& $log) { $log[] = func_get_args(); return $v . $v; }
+	);
+	Assert::same(['aa', 'bb'], $res);
+	Assert::same([['a', 0, $arr], ['b', 1, $arr]], $log);
+});
+
+test(function () {
+	$arr = ['x' => 'a', 'y' => 'b'];
+	$log = [];
+	$res = Arrays::map(
+		$arr,
+		function ($v, $k, $arr) use (& $log) { $log[] = func_get_args(); return $v . $v; }
+	);
+	Assert::same(['x' => 'aa', 'y' => 'bb'], $res);
+	Assert::same([['a', 'x', $arr], ['b', 'y', $arr]], $log);
+});

tests/Utils/Arrays.some().phpt

@@ -0,0 +1,78 @@
+<?php
+
+/**
+ * Test: Nette\Utils\Arrays::some()
+ */
+
+use Nette\Utils\Arrays;
+use Tester\Assert;
+
+
+require __DIR__ . '/../bootstrap.php';
+
+
+test(function () {
+	$arr = [];
+	$log = [];
+	$res = Arrays::some(
+		$arr,
+		function ($v, $k, $arr) use (& $log) { $log[] = func_get_args(); return FALSE; }
+	);
+	Assert::false($res);
+	Assert::same([], $log);
+});
+
+test(function () {
+	$arr = [];
+	$log = [];
+	$res = Arrays::some(
+		$arr,
+		function ($v, $k, $arr) use (& $log) { $log[] = func_get_args(); return TRUE; }
+	);
+	Assert::false($res);
+	Assert::same([], $log);
+});
+
+test(function () {
+	$arr = ['a', 'b'];
+	$log = [];
+	$res = Arrays::some(
+		$arr,
+		function ($v, $k, $arr) use (& $log) { $log[] = func_get_args(); return FALSE; }
+	);
+	Assert::false($res);
+	Assert::same([['a', 0, $arr], ['b', 1, $arr]], $log);
+});
+
+test(function () {
+	$arr = ['a', 'b'];
+	$log = [];
+	$res = Arrays::some(
+		$arr,
+		function ($v, $k, $arr) use (& $log) { $log[] = func_get_args(); return TRUE; }
+	);
+	Assert::true($res);
+	Assert::same([['a', 0, $arr]], $log);
+});
+
+test(function () {
+	$arr = ['a', 'b'];
+	$log = [];
+	$res = Arrays::some(
+		$arr,
+		function ($v, $k, $arr) use (& $log) { $log[] = func_get_args(); return $v === 'a'; }
+	);
+	Assert::true($res);
+	Assert::same([['a', 0, $arr]], $log);
+});
+
+test(function () {
+	$arr = ['x' => 'a', 'y' => 'b'];
+	$log = [];
+	$res = Arrays::some(
+		$arr,
+		function ($v, $k, $arr) use (& $log) { $log[] = func_get_args(); return $v === 'a'; }
+	);
+	Assert::true($res);
+	Assert::same([['a', 'x', $arr]], $log);
+});