Added isNested and getDepth methods

Author: minwork

README.md

@@ -52,6 +52,7 @@ Here, you can quickly get started by becoming familiar with each and every metho
 * [isAssoc](#isassocarray-array-bool-strict--false-bool)
 * [isNumeric](#isnumericarray-array-bool)
 * [isUnique](#isuniquearray-array-bool-strict--false-bool)
+* [isNested](#isnestedarray-array-bool)
 * [isArrayOfArrays](#isarrayofarraysarray-array-bool)
 ### Manipulation
 * Mapping
@@ -77,6 +78,7 @@ Here, you can quickly get started by becoming familiar with each and every metho
 ### Utilities
 * [createMulti](#createmultiarray-keys-array-values--null-array)
 * [forceArray](#forcearraymixed-var-int-flag--selfforce_array_all-mixed)
+* [getDepth](#getdeptharray-array-int)
 * [clone](#clonearray-array-array)
 * [random](#randomarray-array-int-count--1-mixed)
 * [shuffle](#shufflearray-array-array)
@@ -265,6 +267,19 @@ Arr::isUnique([1, '1', true]) -> false
 Arr::isUnique([1, '1', true], true) -> true
 ```
 
+### `isNested(array $array): bool`
+Check if any element of an array is also an array
+
+```php
+Arr::isNested([]) -> false
+
+Arr::isNested([1, 2, 3]) -> false
+
+Arr::isNested([1, 2 => [], 3]) -> true
+
+Arr::isNested([1, 2 => [[[]]], 3 => []]) -> true
+```
+
 ### `isArrayOfArrays(array $array): bool`
 Check if every array element is array
 
@@ -826,6 +841,27 @@ Arr::forceArray($object) -> [$object]
 Arr::forceArray($object, Arr::FORCE_ARRAY_PRESERVE_ARRAY_OBJECTS) -> $object
 ```
 
+### `getDepth(array $array): int`
+Get nesting depth of an array
+
+```php
+Arr::getDepth([]) -> 1
+
+Arr::getDepth([1, 2, 3]) -> 1
+
+Arr::getDepth([1, 2 => [], 3]) -> 2
+
+Arr::getDepth([
+    1, 
+    2 => [
+        3 => [
+            4 => []
+        ]
+    ], 
+    5 => []
+]) -> 4
+```
+
 ### `clone(array $array): array`
 Copy array and clone every object inside it
 

src/Arr.php

@@ -305,7 +305,24 @@ public static function isUnique(array $array, bool $strict = false): bool
     }
 
     /**
-     * Check if every array element is array
+     * Check if any element of an array is also an array
+     *
+     * @param array $array
+     * @return bool
+     */
+    public static function isNested(array $array): bool
+    {
+        foreach ($array as $element) {
+            if (is_array($element)) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    /**
+     * Check if every element of an array is array
      *
      * @param array $array
      * @return bool
@@ -782,6 +799,36 @@ public static function forceArray($var, int $flag = self::FORCE_ARRAY_ALL)
     }
 
 
+    /**
+     * Get nesting depth of an array.<br>
+     * <br>
+     * Depth is calculated by counting amount of nested arrays - each nested array increase depth by one.
+     * Nominal depth of an array is 1.
+     *
+     * @param array $array
+     * @return int
+     */
+    public static function getDepth(array $array): int
+    {
+        $depth = 0;
+        $queue = [$array];
+
+        do {
+            ++$depth;
+            $current = $queue;
+            $queue = [];
+            foreach ($current as $element) {
+                foreach ($element as $value) {
+                    if (is_array($value)) {
+                        $queue[] = $value;
+                    }
+                }
+            }
+        } while(!empty($queue));
+
+        return $depth;
+    }
+
     /**
      * Copy array and clone every object inside it
      *

test/ArrTest.php

@@ -238,6 +238,15 @@ public function testIsUnique()
         $this->assertFalse(Arr::isUnique([1, 1, 1], true));
     }
 
+    public function testIsNested()
+    {
+        $this->assertFalse(Arr::isNested([]));
+        $this->assertFalse(Arr::isNested([1, 2, 3, 'a', 'b']));
+        $this->assertTrue(Arr::isNested([[], []]));
+        $this->assertTrue(Arr::isNested([[]]));
+        $this->assertTrue(Arr::isNested([1, 2 => []]));
+    }
+
     public function testIsArrayOfArrays()
     {
         $this->assertFalse(Arr::isArrayOfArrays([]));
@@ -983,6 +992,33 @@ public function testForceArray()
         $this->assertSame([$function], Arr::forceArray($function));
     }
 
+    public function testGetDepth()
+    {
+        $this->assertSame(1, Arr::getDepth([]));
+        $this->assertSame(1, Arr::getDepth([1, 2, 3, 4, 'a', 'b', 'c']));
+        $this->assertSame(2, Arr::getDepth([[]]));
+        $this->assertSame(5, Arr::getDepth([
+            [],
+            'a' => [
+                'b' => [
+                    'c' => 2,
+                    'd' => [
+                        [],
+                        'e' => 'test',
+                    ],
+                    [
+                        'f' => []
+                    ]
+                ]
+            ],
+            10,
+            'foo' => [
+                'bar',
+                []
+            ]
+        ]));
+    }
+
     public function testClone()
     {
         $object = new stdClass();