Add except(), returns a sequence with values except those passed

[thekid]

This pull request adds an except() method to sequences.

Example

use util\data\Sequence;

$remaining= Sequence::of([1, 2, 3, 4])->except(2, 4)->toArray(); // [1, 3]

This is basically a shorthand for the following:

use util\data\Sequence;

$remaining= Sequence::of([1, 2, 3, 4])
  ->filter(fn($e) => !in_array($e, [2, 4]))
  ->toArray()
;

...but it also works for arbitrary objects, including those implementing object comparison, which in_array() does not honor.

See also

• https://learn.microsoft.com/en-us/dotnet/api/system.linq.enumerable.except - similar functionality in .NET
• https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/filter-not.html - using seq.filterNot { it in exclude }

[thekid]

Released in https://github.com/xp-forge/sequence/releases/tag/v10.4.0