Added \iter\last().

Author: Bilge

src/iter.php

@@ -1290,6 +1290,19 @@ function tap(callable $function, iterable $iterable): \Iterator {
     }
 }
 
+/**
+ * Returns the last value of the specified iterable.
+ *
+ * @param iterable $iterable Iterable.
+ *
+ * @return mixed Last value of the iterable if it contains values, otherwise null.
+ */
+function last(iterable $iterable): mixed {
+    foreach ($iterable as $value) {}
+
+    return $value ?? null;
+}
+
 /*
  * Python:
  * compress()

test/iterTest.php

@@ -644,6 +644,11 @@ public function testTap() {
             toArray(tap([$mock, 'foo'], [1, 2, 3]))
         );
     }
+
+    public function testLast() {
+        self::assertSame(3, last(range(1, 3)));
+        self::assertNull(last(new \EmptyIterator()));
+    }
 }
 
 class _CountableTestDummy implements \Countable {