added Iterables::fromPairs()

Author: dg

src/Utils/Iterables.php

@@ -178,6 +178,21 @@ public static function mapWithKeys(iterable $iterable, callable $transformer): \
 	}
 
 
+	/**
+	 * Creates an iterator from an array of [key, value] pairs.
+	 * @template K
+	 * @template V
+	 * @param  iterable<array{K, V}>  $pairs
+	 * @return \Generator<K, V>
+	 */
+	public static function fromPairs(iterable $pairs): \Generator
+	{
+		foreach ($pairs as $pair) {
+			yield $pair[0] => $pair[1];
+		}
+	}
+
+
 	/**
 	 * Creates a repeatable iterator from a factory function.
 	 * The factory is called every time the iterator is iterated.

tests/Utils/Iterables.fromPairs().phpt

@@ -0,0 +1,39 @@
+<?php
+
+/**
+ * Test: Nette\Utils\Iterables::fromPairs()
+ */
+
+declare(strict_types=1);
+
+use Nette\Utils\Iterables;
+use Tester\Assert;
+
+require __DIR__ . '/../bootstrap.php';
+
+
+// Basic test
+$result = [];
+$pairs = [['a', 1], ['a', 2], ['c', 3]];
+foreach (Iterables::fromPairs($pairs) as $k => $v) {
+	$result[] = [$k, $v];
+}
+Assert::same($pairs, $result);
+
+
+// Test with null key
+$result = [];
+$pairs = [[null, 'null'], [[], 'array']];
+foreach (Iterables::fromPairs($pairs) as $k => $v) {
+	$result[] = [$k, $v];
+}
+Assert::same($pairs, $result);
+
+
+// Test with iterator
+$result = [];
+$pairs = [['a', 1], ['b', 2]];
+foreach (Iterables::fromPairs(new ArrayIterator($pairs)) as $k => $v) {
+	$result[] = [$k, $v];
+}
+Assert::same($pairs, $result);