Arr::kvjoin() and Arr::first() now accept iterables

Author: nix

README.md

@@ -38,14 +38,14 @@ $callback = fn($carry, $v, $k) => "$carry|$k";
 Arr::reduce($array, $callback, "") // => "|a|b|1|2"
 ```
 
-* `kvjoin(array $data, string $sep = ', ', string $kv_sep = '='): string`<br>
+* `kvjoin(iterable $iterable, string $sep = ', ', string $kv_sep = '='): string`<br>
   Like implode()/join() in legacy syntax, but outputs the keys too and takes an additional parameter `$kv_sep`.
 ```php
 $array = ['a' => 'A', 'b' => 'B', 1 => 'one', 2 => 'two'];
 Arr::kvjoin($array) // => "a=A, b=B, 1=one, 2=two"
 ```
 
-* `first(array $array): array`<br>
+* `first(iterable $iterable): array`<br>
   Returns the first mapping (element) of an array as key and value in an array, or null/null if the array is empty.
 ```php
 $array = ['a' => 'A', 'b' => 'B', 1 => 'one', 2 => 'two'];
@@ -62,7 +62,7 @@ Arr::find($array, 'c', 1) // => ['k' => 1, 'v' => 'one']
 Arr::find($array, 'c', 3) // => ['k' => null, 'v' => null]
 ```
 
-The return value for the last two functions are well suited for array destruction and safety on searching:
+The return value for the last two functions is well suited for array destruction and safety on searching:
 ```php
 ['k' => $key, 'v' => $value] = Arr::find($array, 2, 'b');
 if ($key === null)

src/Arr.php

@@ -74,7 +74,7 @@ public static function reduce(iterable $iterable, callable $callback, mixed $ini
 	 * @param string $kv_sep the separator for key and value
 	 * @since 1.0
 	 */
-	public static function kvjoin(array $data, string $sep = ', ', string $kv_sep = '='): string
+	public static function kvjoin(iterable $data, string $sep = ', ', string $kv_sep = '='): string
 	{
 		$first = true;
 		$str = '';
@@ -88,21 +88,21 @@ public static function kvjoin(array $data, string $sep = ', ', string $kv_sep =
 
 	/**
 	 * Returns the first mapping (element) of an array as key and value in an array, or null/null if the array is empty.
-	 * Array destructuring is a very convenient way to handle the result: `['k' => $key, 'v' => $value] = array_first($array)`
-	 * @param array $array the source array
+	 * Array destructuring is a very convenient way to handle the result: `['k' => $key, 'v' => $value] = Arr::first($array)`
+	 * @param iterable $iterable the source iterable
 	 * @return array ['k' => <key>/null, 'v' => <value>/null]
 	 * @since 1.0
 	 */
-	public static function first(array $array): array
+	public static function first(iterable $iterable): array
 	{
-		foreach ($array as $k => $v)
+		foreach ($iterable as $k => $v)
 			return compact('k', 'v');
 		return ['k' => null, 'v' => null];
 	}
 
 	/**
 	 * Searches for a mapping in the array whose key is one of $keys, returns the key and the value or null/null (if not found) as an array.
-	 * Array destructuring is a very convenient way to handle the result: `['k' => $key, 'v' => $value] = array_find($array, 'key1', 'key2')`
+	 * Array destructuring is a very convenient way to handle the result: `['k' => $key, 'v' => $value] = Arr::find($array, 'key1', 'key2')`
 	 * @param array $array the source array
 	 * @param string|int ...$ks the keys
 	 * @return array ['k' => <key>/null, 'v' => <value>/null]