feat: add Collection::reject

Author: Fureev Eugene

CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog][keepachangelog] and this project adheres to [Semantic Versioning][semver].
 
+## v4.18.0
+
+### Added
+
+- Add function `Collection::reject`
+
 ## v4.17.1
 
 ### Changed

src/Structures/Collections/ArrayCollection.php

@@ -287,6 +287,17 @@ public function filter(Closure $func = null): static
         return $this->createFrom(array_filter($this->elements, $func, ARRAY_FILTER_USE_BOTH));
     }
 
+    /**
+     * {@inheritDoc}
+     *
+     * @return static
+     * @psalm-return static<TKey,T>
+     */
+    public function reject(Closure $callback): static
+    {
+        return $this->filter(static fn($value, $key) => !$callback($value, $key));
+    }
+
     /**
      * {@inheritDoc}
      */

src/Structures/Collections/ReadableCollection.php

@@ -170,6 +170,17 @@ public function exists(Closure $func): bool;
      */
     public function filter(Closure $func = null): ReadableCollection;
 
+    /**
+     * Create a collection of all elements that do not pass a given truth test.
+     *
+     * @param Closure $func The predicate used for filtering.
+     * @psalm-param Closure(T, TKey):bool $func
+     *
+     * @return ReadableCollection<mixed> A collection with the results of the filter operation.
+     * @psalm-return ReadableCollection<TKey, T>
+     */
+    public function reject(Closure $callback): ReadableCollection;
+
     /**
      * Applies the given function to each element in the collection and returns
      * a new collection with the elements returned by the function.