Merge pull request #32 from transprime-research/feat-add-array-search

feat: Add array search

src/Traits/ArrayPrefix.php

@@ -85,6 +85,17 @@ public function walkRecursive(callable $callable, $arg = null)
         return $this->setResult($workableItem);
     }
 
+    public function search($needle, bool $strict = true, $default = null)
+    {
+        $result = array_search($needle, $this->getWorkableItem(), $strict);
+
+        if ($result === false) {
+            return $default;
+        }
+
+        return $result;
+    }
+
 
     /**
      * Like php array_key_exists, this instead search if (one or more) keys exists in the array

tests/ArrayPrefixTraitTest.php

@@ -247,4 +247,26 @@ public function testTail(): void
 
         arrayed([])->tail();
     }
+
+    public function testSearch(): void
+    {
+        $data = ['a', 'b', 'c', 'd'];
+
+        $this->assertSame(
+            1,
+            arrayed($data)->search('b'),
+        );
+
+        // When there is no matching value.
+        $this->assertEquals(
+            null,
+            arrayed($data)->search('z'),
+        );
+
+        // With default value.
+        $this->assertEquals(
+            false,
+            arrayed($data)->search('z', true, false),
+        );
+    }
 }