The assertStringContainsStringIgnoringCase() function is a builtin function in PHPUnit and is used to assert a string containing a substring but ignoring the case of substring. This assertion will return true in the case if the string contains the 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:
assertStringContainsStringIgnoringCase(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 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 assertStringContainsStringIgnoringCase() function:
Program 1:
<?php use PHPUnit\Framework\TestCase; class GeeksPhpunitTestCase extends TestCase { public function testNegativeTestcaseForAssertStringContainsStringIgnoringCase() { $testString = "geekforgeek"; $substring = "neveropen"; // assert function to test whether 'neveropen' is a substring of testString ignoring case-sensitivity $this->assertStringContainsStringIgnoringCase($substring, $testString, "testString doesn't contains 'neveropen' as substring") ; } } ?> |
Output:
PHPUnit 8.2.5 by Sebastian Bergmann and contributors. F 1 / 1 (100%) Time: 67 ms, Memory: 10.00 MB There was 1 failure: 1) GeeksPhpunitTestCase::testNegativeTestcaseForAssertStringContainsStringIgnoringCase testString doesn't contains 'neveropen' as substring Failed asserting that 'geekforgeek' contains "neveropen". /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 testPositiveTestcaseForAssertStringContainsStringIgnoringCase() { $testString = "geekforgeek"; $substring = "geEk"; // assert function to test whether 'gEek' is a substring of testString $this->assertStringContainsStringIgnoringCase($substring, $testString, "testString doesn't contains 'geEk' 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, assertStringContainsStringIgnoringCase() is supported by phpunit 7 and above.
