The assertContains() function is a builtin function in PHPUnit and is used to assert an array having a value. This assertion will return true in the case if the array contains the provided value else return false and in case of true the asserted test case got passed else test case got failed.
Syntax:
assertContains(mixed $value, array $array, string $message = ''])
Parameters: This function accepts three parameters as shown in the above syntax. The parameters are described below:
- $value: This parameter represents the value to be contained in array.
- $array: This parameter is a array for which the assert function will check whether it contains value 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 assertContains() function:
Program 1:
<?php use PHPUnit\Framework\TestCase; class GeeksPhpunitTestCase extends TestCase { public function testNegativeTestcaseForAssertContains() { $testArray = array ( "a" => "value b" , "b" => "value b" ); $value = "value ba" ; // assert function to test whether 'value' is a value of array $this ->assertContains( $value , $testArray , "testArray doesn't contains value as value" ) ; } } ?> |
Output:
Program 2:
<?php
use
PHPUnit\Framework\TestCase;
class
GeeksPhpunitTestCase
extends
TestCase
{
public
function
testPositiveTestcaseForAssertContains()
{
$testArray
=
array
(
"a"
=>
"value ba"
,
"b"
=>
"value b"
);
$value
=
"value ba"
;
// assert function to test whether 'value' is a value of array
$this
->assertContains(
$value
,
$testArray
,
"testArray doesn't 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.