From 740520b2b32233adf7a49388e3cc6c2b5b74535d Mon Sep 17 00:00:00 2001
From: David Grudl <david@grudl.com>
Date: Mon, 11 Jan 2021 00:03:10 +0100
Subject: [PATCH] added Arrays::first(), last() & contains()

---
 src/Utils/Arrays.php               | 30 ++++++++++++++++++++++++++++++
 tests/Utils/Arrays.contains().phpt | 16 ++++++++++++++++
 tests/Utils/Arrays.first().phpt    | 21 +++++++++++++++++++++
 tests/Utils/Arrays.last().phpt     | 20 ++++++++++++++++++++
 4 files changed, 87 insertions(+)
 create mode 100644 tests/Utils/Arrays.contains().phpt
 create mode 100644 tests/Utils/Arrays.first().phpt
 create mode 100644 tests/Utils/Arrays.last().phpt

diff --git a/src/Utils/Arrays.php b/src/Utils/Arrays.php
index 8f78fcc39..a93fe7ddf 100644
--- a/src/Utils/Arrays.php
+++ b/src/Utils/Arrays.php
@@ -99,6 +99,36 @@ public static function searchKey(array $array, $key): ?int
 	}
 
 
+	/**
+	 * Tests an array for the presence of value.
+	 * @param  mixed  $value
+	 */
+	public static function contains(array $array, $value): bool
+	{
+		return in_array($value, $array, true);
+	}
+
+
+	/**
+	 * Returns the first item from the array or null.
+	 * @return mixed
+	 */
+	public static function first(array $array)
+	{
+		return count($array) ? reset($array) : null;
+	}
+
+
+	/**
+	 * Returns the last item from the array or null.
+	 * @return mixed
+	 */
+	public static function last(array $array)
+	{
+		return count($array) ? end($array) : null;
+	}
+
+
 	/**
 	 * Inserts the contents of the $inserted array into the $array immediately after the $key.
 	 * If $key is null (or does not exist), it is inserted at the beginning.
diff --git a/tests/Utils/Arrays.contains().phpt b/tests/Utils/Arrays.contains().phpt
new file mode 100644
index 000000000..5bc808768
--- /dev/null
+++ b/tests/Utils/Arrays.contains().phpt
@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+use Nette\Utils\Arrays;
+use Tester\Assert;
+
+
+require __DIR__ . '/../bootstrap.php';
+
+
+Assert::false(Arrays::contains([], 'a'));
+Assert::true(Arrays::contains(['a'], 'a'));
+Assert::true(Arrays::contains([1, 2, 'a'], 'a'));
+Assert::false(Arrays::contains([1, 2, 3], 'a'));
+Assert::false(Arrays::contains([1, 2, 3], '1'));
diff --git a/tests/Utils/Arrays.first().phpt b/tests/Utils/Arrays.first().phpt
new file mode 100644
index 000000000..6aa4925a1
--- /dev/null
+++ b/tests/Utils/Arrays.first().phpt
@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+use Nette\Utils\Arrays;
+use Tester\Assert;
+
+
+require __DIR__ . '/../bootstrap.php';
+
+
+Assert::null(Arrays::first([]));
+Assert::null(Arrays::first([null]));
+Assert::false(Arrays::first([false]));
+Assert::same(1, Arrays::first([1, 2, 3]));
+
+
+$arr = [1, 2, 3];
+end($arr);
+Assert::same(1, Arrays::first($arr));
+Assert::same(3, current($arr));
diff --git a/tests/Utils/Arrays.last().phpt b/tests/Utils/Arrays.last().phpt
new file mode 100644
index 000000000..58ed411c7
--- /dev/null
+++ b/tests/Utils/Arrays.last().phpt
@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+use Nette\Utils\Arrays;
+use Tester\Assert;
+
+
+require __DIR__ . '/../bootstrap.php';
+
+
+Assert::null(Arrays::last([]));
+Assert::null(Arrays::last([null]));
+Assert::false(Arrays::last([false]));
+Assert::same(3, Arrays::last([1, 2, 3]));
+
+
+$arr = [1, 2, 3];
+Assert::same(3, Arrays::last($arr));
+Assert::same(1, current($arr));