- Upgraded doc intro to match new attribute uses.

src/EntityCollection.php

@@ -58,6 +58,26 @@ class EntityCollection extends \ArrayObject {
         return null;
     }
 
+    public function extract(Callable $callback) : self
+    {
+        $idx = 0;
+        $replace = [];
+        $collection = new static();
+
+        foreach($this as $key => $item) {
+            if ( $callback($item, $key, $idx++) ) {
+                $collection->append($item);
+            }
+            else {
+                $replace[] = $item;
+            }
+        }
+
+        $this->replaceWith($replace);
+
+        return $collection;
+    }
+
     public function iterate(Callable $callback) : self
     {
         foreach($this as $item) {
@@ -117,17 +137,17 @@ class EntityCollection extends \ArrayObject {
 
     public function searchAll(/* mixed*/ $values, string $field, bool $strict = true, bool $compareArray = false) : self
     {
-        $obj = new static();
+        $collection = new static();
 
         $values = is_array($values) && $compareArray ? [ $values ] : $values;
 
         foreach((array) $values as $value) {
             foreach ($this->search($value, $field, $strict) as $item) {
-                $obj->append($item);
+                $collection->append($item);
             }
         }
 
-        return $obj;
+        return $collection;
     }
 
     public function diffAll(/* mixed */ $values, string $field, bool $strict = true, bool $compareArray = false) : self