PHPUnit | assertNotContains() function

The assertNotContains() function is a builtin function in PHPUnit and is used to assert an array not having a value. This assertion will return true in the case if the array doesn’t contain the provided value else return false and in case of true the asserted test case got passed else test case got failed.

Syntax:

assertNotContains(mixed $value, array $array, string $message = ''])

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

1. $value: This parameter represents the value not to be contained in array.
2. $array: This parameter is a array for which the assert function will check whether it contains value or not.
3. $message: This parameter takes string value. When the testcase got failed this string message got displayed as error message.

Below programs illustrate the assertNotContains() function:

Program 1:

<?php
use PHPUnit\Framework\TestCase;

class GeeksPhpunitTestCase extends TestCase
{
    public function testNegativeTestcaseForAssertNotContains()
    {
        $testArray = array("a"=>"value ba", "b" =>"value b");
        $value = "value ba";
        // assert function to test whether 'value' is a value of array
        $this->assertNotContains($value, $testArray, "testArray contains value as value") ;
    }
}

?>

Output:

PHPUnit 6.5.5 by Sebastian Bergmann and contributors.

F                                                                   1 / 1 (100%)

Time: 21 ms, Memory: 4.00MB

There was 1 failure:

1) GeeksPhpunitTestCase::testNegativeTestcaseForAssertNotContains
testArray contains value as value
Failed asserting that an array does not contain 'value ba'.

/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 testPositiveTestcaseForAssertNotContains()
    {
        $testArray = array("a"=>"value ba", "b" =>"value b");
        $value = "value b";
        // assert function to test whether 'value' is a value of array
        $this->assertNotContains($value, $testArray, "testArray contains value as value") ;
    }
}

?>

Output:

PHPUnit 6.5.5 by Sebastian Bergmann and contributors.

.                                                                   1 / 1 (100%)

Time: 21 ms, Memory: 4.00MB

OK (1 test, 1 assertion)

Note : To run testcases with phpunit follow steps from here.