Add 'not contains' operator to Comparison

docs/en/expression-builder.rst

@@ -154,6 +154,16 @@ contains
 
     $collection->matching(new Criteria($expression));
 
+notContains
+--------
+
+.. code-block:: php
+    $expressionBuilder = Criteria::expr();
+
+    $expression = $expressionBuilder->notContains('foo', 'value1');
+
+    $collection->matching(new Criteria($expression));
+
 memberOf
 --------
 

docs/en/expressions.rst

@@ -16,6 +16,7 @@ following operator constants:
 - ``Comparison::IN``
 - ``Comparison::NIN``
 - ``Comparison::CONTAINS``
+- ``Comparison::NCONTAINS``
 - ``Comparison::MEMBER_OF``
 - ``Comparison::STARTS_WITH``
 - ``Comparison::ENDS_WITH``

src/Expr/ClosureExpressionVisitor.php

@@ -144,6 +144,7 @@ public function walkComparison(Comparison $comparison)
                 return ! in_array($fieldValue, $value, is_scalar($fieldValue));
             },
             Comparison::CONTAINS => static fn ($object): bool => str_contains((string) self::getObjectFieldValue($object, $field), (string) $value),
+            Comparison::NCONTAINS => static fn ($object): bool => ! str_contains((string) self::getObjectFieldValue($object, $field), (string) $value),
             Comparison::MEMBER_OF => static function ($object) use ($field, $value): bool {
                 $fieldValues = ClosureExpressionVisitor::getObjectFieldValue($object, $field);
 

src/Expr/Comparison.php

@@ -19,6 +19,7 @@ class Comparison implements Expression
     final public const IN          = 'IN';
     final public const NIN         = 'NIN';
     final public const CONTAINS    = 'CONTAINS';
+    final public const NCONTAINS   = 'NCONTAINS';
     final public const MEMBER_OF   = 'MEMBER_OF';
     final public const STARTS_WITH = 'STARTS_WITH';
     final public const ENDS_WITH   = 'ENDS_WITH';

src/ExpressionBuilder.php

@@ -103,6 +103,12 @@ public function contains(string $field, mixed $value)
         return new Comparison($field, Comparison::CONTAINS, new Value($value));
     }
 
+    /** @return Comparison */
+    public function notContains(string $field, mixed $value)
+    {
+        return new Comparison($field, Comparison::NCONTAINS, new Value($value));
+    }
+
     /** @return Comparison */
     public function memberOf(string $field, mixed $value)
     {

tests/Common/Collections/ExpressionBuilderTest.php

@@ -122,6 +122,14 @@ public function testContains(): void
         self::assertEquals(Comparison::CONTAINS, $expr->getOperator());
     }
 
+    public function testNotContains(): void
+    {
+        $expr = $this->builder->notContains('a', 'b');
+
+        self::assertInstanceOf(Comparison::class, $expr);
+        self::assertEquals(Comparison::NCONTAINS, $expr->getOperator());
+    }
+
     public function testMemberOf(): void
     {
         $expr = $this->builder->memberOf('b', ['a']);