The assertEqualsIgnoringCase() function is a builtin function in PHPUnit and is used to check whether the expected string is equal to actual string ignoring the string-case of expected string. This assertion will return true in the case if the actual string is equal to expected string ignoring case-sensitivity, else return false. In case of true the asserted test case got passed else test case got failed.
Syntax:
assertEqualsIgnoringCase(mixed $expected, mixed $actual[, string $message = '']
Parameters: This function accepts three parameters as shown in the above syntax. The parameters are described below:
- $expected: This parameter is a string that represents the expected data.
- $actual: This parameter is a string that represents the actual data.
- $message: This parameter takes a string value. When the test case got failed this string message got displayed as an error message.
Below programs illustrate the assertEqualsIgnoringCase() function:
Example 1:
PHP
<?php use PHPUnit\Framework\TestCase; class GeeksPhpunitTestCase extends TestCase { public function testNegativeTestcaseForAssertequalIgnoringCase() { $expected = "Geek" ; $actual = "geEks" ; // assert function to test whether expected string // is equal or not to actual ignoring case $this ->assertEqualsIgnoringCase( $actual , $expected , "expected is not equal to actual ignoring case" ) ; } } ?> |
Output:
PHPUnit 8.5.8 by Sebastian Bergmann and contributors. F 1 / 1 (100%) Time: 88 ms, Memory: 10.00 MB There was 1 failure: 1) GeeksPhpunitTestCase::testNegativeTestcaseForAssertequalIgnoringCase expected is not equal to actual ignoring case Failed asserting that two strings are equal. --- Expected +++ Actual @@ @@ -'geEks' +'Geek' /home/lovely/Documents/php/test.php:17 FAILURES! Tests: 1, Assertions: 1, Failures: 1.
Example 2:
PHP
<?php use PHPUnit\Framework\TestCase; class GeeksPhpunitTestCase extends TestCase { public function testPositiveTestcaseForAssertequalIgnoringCase() { $expected = "Geeks" ; $actual = "geEks" ; // assert function to test whether expected // is equal or not to actual ignoring case $this ->assertEqualsIgnoringCase( $actual , $expected , "expected is not equal to actual ignoring case" ) ; } } ?> |
Output:
PHPUnit 8.5.8 by Sebastian Bergmann and contributors. . 1 / 1 (100%) Time: 91 ms, Memory: 10.00 MB OK (1 test, 1 assertion)
Reference: https://phpunit.readthedocs.io/en/9.2/assertions.html#assertequalsignoringcase