3 * This file is part of the Comparator package.
5 * (c) Sebastian Bergmann <sebastian@phpunit.de>
7 * For the full copyright and license information, please view the LICENSE
8 * file that was distributed with this source code.
11 namespace SebastianBergmann\Comparator;
14 * Compares scalar or NULL values for equality.
16 class ScalarComparator extends Comparator
19 * Returns whether the comparator can compare two values.
21 * @param mixed $expected The first value to compare
22 * @param mixed $actual The second value to compare
24 * @since Method available since Release 3.6.0
26 public function accepts($expected, $actual)
28 return ((is_scalar($expected) xor null === $expected) &&
29 (is_scalar($actual) xor null === $actual))
30 // allow comparison between strings and objects featuring __toString()
31 || (is_string($expected) && is_object($actual) && method_exists($actual, '__toString'))
32 || (is_object($expected) && method_exists($expected, '__toString') && is_string($actual));
36 * Asserts that two values are equal.
38 * @param mixed $expected First value to compare
39 * @param mixed $actual Second value to compare
40 * @param float $delta Allowed numerical distance between two values to consider them equal
41 * @param bool $canonicalize Arrays are sorted before comparison when set to true
42 * @param bool $ignoreCase Case is ignored when set to true
44 * @throws ComparisonFailure
46 public function assertEquals($expected, $actual, $delta = 0.0, $canonicalize = false, $ignoreCase = false)
48 $expectedToCompare = $expected;
49 $actualToCompare = $actual;
51 // always compare as strings to avoid strange behaviour
52 // otherwise 0 == 'Foobar'
53 if (is_string($expected) || is_string($actual)) {
54 $expectedToCompare = (string) $expectedToCompare;
55 $actualToCompare = (string) $actualToCompare;
58 $expectedToCompare = strtolower($expectedToCompare);
59 $actualToCompare = strtolower($actualToCompare);
63 if ($expectedToCompare != $actualToCompare) {
64 if (is_string($expected) && is_string($actual)) {
65 throw new ComparisonFailure(
68 $this->exporter->export($expected),
69 $this->exporter->export($actual),
71 'Failed asserting that two strings are equal.'
75 throw new ComparisonFailure(
78 // no diff is required
83 'Failed asserting that %s matches expected %s.',
84 $this->exporter->export($actual),
85 $this->exporter->export($expected)