Added array functions

Author: assertchris

src/ArrayFunctions.php

@@ -2,3 +2,116 @@
 
 namespace TypedPHP\Functions\ArrayFunctions;
 
+/**
+ * @param array $haystack
+ * @param mixed $needle
+ *
+ * @return bool
+ */
+function contains(array $haystack, $needle)
+{
+    return in_array($needle, $haystack);
+}
+
+/**
+ * @param array    $array
+ * @param callable $callback
+ *
+ * @return bool
+ */
+function each(array $array, callable $callback)
+{
+    return array_walk($array, $callback);
+}
+
+/**
+ * @param array $array
+ * @param array $exclude
+ *
+ * @return array
+ */
+function exclude(array $array, array $exclude)
+{
+    return array_diff($array, $exclude);
+}
+
+/**
+ * @param array    $array
+ * @param callable $callback
+ *
+ * @return array
+ */
+function filter(array $array, callable $callback)
+{
+    return array_filter($array, $callback);
+}
+
+/**
+ * @param array $array
+ *
+ * @return int
+ */
+function length(array $array)
+{
+    return count($array);
+}
+
+/**
+ * @param array $array
+ * @param mixed $needle
+ *
+ * @return bool
+ */
+function has(array $array, $needle)
+{
+    return array_key_exists($needle, $array);
+}
+
+/**
+ * @param array  $array
+ * @param string $glue
+ *
+ * @return string
+ */
+function join(array $array, $glue)
+{
+    return \join($glue, $array);
+}
+
+/**
+ * @param array    $array
+ * @param callable $callback
+ *
+ * @return array
+ */
+function map(array $array, callable $callback)
+{
+    return array_map($callback, $array);
+}
+
+/**
+ * @param array $array
+ * @param array $merge
+ *
+ * @return array
+ */
+function merge(array $array, array $merge)
+{
+    return array_merge($array, $merge);
+}
+
+/**
+ * @param array $array
+ * @param int   $offset
+ * @param int   $limit
+ *
+ * @return array
+ */
+function slice(array $array, $offset = 0, $limit = 0)
+{
+    if ($limit == 0) {
+        return array_slice($array, $offset);
+    }
+
+    return array_slice($array, $offset, $limit);
+}

tests/ArrayFunctionTest.php

@@ -6,5 +6,73 @@
 
 class ArrayFunctionTest extends Test
 {
+    public function testContains()
+    {
+        $this->assertTrue(ArrayFunctions\contains([1, 2, 3], 2));
+        $this->assertFalse(ArrayFunctions\contains([1, 2, 3], 4));
+    }
 
+    public function testEach()
+    {
+        $expected = [2, 4, 6];
+        $actual = [];
+
+        ArrayFunctions\each([1, 2, 3], function ($item) use (&$actual) {
+            $actual[] = $item * 2;
+        });
+
+        $this->assertEquals($expected, $actual);
+    }
+
+    public function testExclude()
+    {
+        $this->assertEquals([2 => 3], ArrayFunctions\exclude([1, 2, 3], [1, 2]));
+    }
+
+    public function testFilter()
+    {
+        $actual = ArrayFunctions\filter([1, 2, 3], function ($item) {
+            return $item == 2;
+        });
+
+        $this->assertEquals([1 => 2], $actual);
+    }
+
+    public function testGetLength()
+    {
+        $this->assertEquals(3, ArrayFunctions\length([1, 2, 3]));
+    }
+
+    public function testHas()
+    {
+        $this->assertTrue(ArrayFunctions\has(["foo" => "bar"], "foo"));
+        $this->assertFalse(ArrayFunctions\has(["foo" => "bar"], "baz"));
+    }
+
+    public function testJoin()
+    {
+        $this->assertEquals("1,2,3", ArrayFunctions\join([1, 2, 3], ","));
+        $this->assertEquals("1", ArrayFunctions\join([1], ","));
+    }
+
+    public function testMap()
+    {
+        $actual = ArrayFunctions\map([1, 2, 3], function ($item) {
+            return $item * 2;
+        });
+
+        $this->assertEquals([2, 4, 6], $actual);
+    }
+
+    public function testMerge()
+    {
+        $this->assertEquals([1, 2, 3, 4, 5, 6], ArrayFunctions\merge([1, 2, 3], [4, 5, 6]));
+    }
+
+    public function testSlice()
+    {
+        $this->assertEquals([1, 2, 3], ArrayFunctions\slice([1, 2, 3]));
+        $this->assertEquals([2, 3], ArrayFunctions\slice([1, 2, 3], 1));
+        $this->assertEquals([2], ArrayFunctions\slice([1, 2, 3], 1, 1));
+    }
 }