Friday, October 17, 2025
HomeLanguagesPHPUnit | assertNotContains() function

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/neveropen/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.

RELATED ARTICLES

Most Popular

Dominic
32361 POSTS0 COMMENTS
Milvus
88 POSTS0 COMMENTS
Nango Kala
6728 POSTS0 COMMENTS
Nicole Veronica
11892 POSTS0 COMMENTS
Nokonwaba Nkukhwana
11954 POSTS0 COMMENTS
Shaida Kate Naidoo
6852 POSTS0 COMMENTS
Ted Musemwa
7113 POSTS0 COMMENTS
Thapelo Manthata
6805 POSTS0 COMMENTS
Umr Jansen
6801 POSTS0 COMMENTS