Added intersectObjects method

Author: minwork

README.md

@@ -70,6 +70,7 @@ Here, you can quickly get started by becoming familiar with each and every metho
 * Computations
     * [sum](#sumarray-arrays-array)
     * [diffObjects](#diffobjectsarray-array1-array-array2-array-arrays-array)
+    * [intersectObjects](#intersectobjectsarray-array1-array-array2-array-arrays-array)
 * Flattening
     * [flatten](#flattenarray-array-int-depth--null-bool-assoc--false-array)
     * [flattenSingle](#flattensinglearray-array-array)
@@ -611,7 +612,7 @@ Arr::sum([null, '', false], ['1', true, 'test']) -> [1, 1, 0]
 ```
 
 ### `diffObjects(array $array1, array $array2, array ...$arrays): array`
-Differentiate two or more arrays of objects
+Compute difference between two or more arrays of objects
 
 ```php
 $object1 = new \stdClass();
@@ -625,6 +626,21 @@ Arr::diffObjects([$object3, $object1, $object2], [$object3], [$object1, $object2
 Arr::diffObjects([$object1], [$object3], [$object2], []) -> [$object1]
 ```
 
+### `intersectObjects(array $array1, array $array2, array ...$arrays): array`
+Compute intersection between two or more arrays of objects
+
+```php
+$object1 = new \stdClass();
+$object2 = new \stdClass();
+$object3 = new \stdClass();
+
+Arr::intersectObjects([$object3, $object1, $object2], [$object3, $object2], [$object2]) -> [2 => $object2]
+
+Arr::intersectObjects([$object3, $object1, $object2], [$object3], [$object1, $object2]) -> []
+
+Arr::intersectObjects([$object1, $object2, $object3, $object1], [$object1, $object2]) -> [$object1, $object2, 3 => $object1]
+```
+
 ## Flattening
 
 ### `flatten(array $array, ?int $depth = null, bool $assoc = false): array`

src/Arr.php

@@ -607,7 +607,7 @@ public static function sum(array ...$arrays): array
     }
 
     /**
-     * Differentiate two or more arrays of objects
+     * Compute difference between two or more arrays of objects
      *
      * @param array $array1
      * @param array $array2
@@ -625,6 +625,25 @@ public static function diffObjects(array $array1, array $array2, array ...$array
         return array_udiff(...$arguments);
     }
 
+    /**
+     * Compute intersection between two or more arrays of objects
+     *
+     * @param array $array1
+     * @param array $array2
+     * @param array[] $arrays
+     * @return array
+     */
+    public static function intersectObjects(array $array1, array $array2, array ...$arrays): array
+    {
+        $arguments = $arrays;
+        array_unshift($arguments, $array1, $array2);
+        array_push($arguments, function ($obj1, $obj2) {
+            return strcmp(spl_object_hash($obj1), spl_object_hash($obj2));
+        });
+
+        return array_uintersect(...$arguments);
+    }
+
     /**
      * Flatten array of arrays to a n-depth array
      *

test/ArrTest.php

@@ -685,6 +685,17 @@ public function testDiffObjects()
         $this->assertSame([$object1], Arr::diffObjects([$object1], [$object3], [$object2], []));
     }
 
+    public function testIntersectObjects()
+    {
+        $object1 = new stdClass();
+        $object2 = new stdClass();
+        $object3 = new stdClass();
+
+        $this->assertSame([2 => $object2], Arr::intersectObjects([$object3, $object1, $object2], [$object3, $object2], [$object2]));
+        $this->assertSame([], Arr::intersectObjects([$object3, $object1, $object2], [$object3], [$object1, $object2]));
+        $this->assertSame([$object1, $object2, 3 => $object1], Arr::intersectObjects([$object1, $object2, $object3, $object1], [$object1, $object2]));
+    }
+
     public function testFlatten()
     {
         $array = [