PHPUnit | assertStringNotContainsStringIgnoringCase() Function

The assertStringNotContainsStringIgnoringCase() function is a builtin function in PHPUnit and is used to assert that a string doesn’t contains a substring ignoring the case of substring. This assertion will return true in case if the string doesn’t contain a substring as a substring ignoring case-sensitivity, else return false and in case of true the asserted test case got passed else test case got failed.

Syntax:

assertStringNotContainsStringIgnoringCase(string $substring, string $string, string $message = ''])

Parameters: This function accepts three parameters as shown in the above syntax. The parameters are described below:

• $substring: This parameter represents the string to be substring of given string.
• $string: This parameter is a string for which the assert function will check whether it contains substring (ignoring case-sensitivity) or not.
• $message: This parameter takes string value. When the testcase got failed this string message got displayed as error message.

Below programs illustrate the assertStringNotContainsStringIgnoringCase() function:

Program 1:

<?php
use PHPUnit\Framework\TestCase;

class GeeksPhpunitTestCase extends TestCase
{
    public function testNegativeTestcaseForAssertStringNotContainsStringIgnoringCase()
    {
        $testString = "geekforgeek";
        $substring = "gEek";

        // Assert function to test whether 'geek' is a substring of
        // testString ignoring case-sensitivity
        $this->assertStringNotContainsStringIgnoringCase( $substring, $testString,
                "testString contains 'gEek' as substring" );
    }
}

?>

Output:

PHPUnit 8.2.5 by Sebastian Bergmann and contributors.

F                                                                   1 / 1 (100%)

Time: 63 ms, Memory: 10.00 MB

There was 1 failure:

1) GeeksPhpunitTestCase::testNegativeTestcaseForAssertStringNotContainsStringIgnoringCase
testString  contains 'gEek' as substring
Failed asserting that 'geekforgeek' does not contain "geek".

/home/shivam/Documents/geeks/phpunit/abc.php:11

FAILURES!
Tests: 1, Assertions: 1, Failures: 1.

Program 2:

<?php
use PHPUnit\Framework\TestCase;

class GeeksPhpunitTestCase extends TestCase
{
    public function testPositiveTestcaseForAssertStringNotContainsStringIgnoringCase()
    {
        $testString = "geekforgeek";
        $substring = "geEks";

        // Assert function to test whether 'gEeks' is a substring of testString
        $this->assertStringNotContainsStringIgnoringCase($substring, $testString,
                    "testString  contains 'geEks' as substring") ;
    }
}

?>

Output:

PHPUnit 8.2.5 by Sebastian Bergmann and contributors.

.                                                                   1 / 1 (100%)

Time: 67 ms, Memory: 10.00 MB

OK (1 test, 1 assertion)

Note: To run testcases with phpunit follow steps from here. Also, assertStringNotContainsStringIgnoringCase() is supported by phpunit 7 and above.