# assertEquals() >[info] ## assertEquals(mixed $expected, mixed $actual[, string $message = '']) 當兩個變量 `$expected` 和 `$actual` 不相等時報告錯誤，錯誤訊息由 `$message` 指定。 `assertNotEquals()` 是與之相反的斷言，接受相同的參數。 `assertAttributeEquals()` 和 `assertAttributeNotEquals()` 是便捷包裝(convenience wrapper)，以某個類或對象的某個 `public`、`protected` 或 `private` 屬性作為實際值來進行比較。 **Example?A.13.?assertEquals() 的用法** ~~~ <?php class EqualsTest extends PHPUnit_Framework_TestCase { public function testFailure() { $this->assertEquals(1, 0); } public function testFailure2() { $this->assertEquals('bar', 'baz'); } public function testFailure3() { $this->assertEquals("foo\nbar\nbaz\n", "foo\nbah\nbaz\n"); } } ?> ~~~ ~~~ phpunit EqualsTest PHPUnit 5.0.0 by Sebastian Bergmann and contributors. FFF Time: 0 seconds, Memory: 5.25Mb There were 3 failures: 1) EqualsTest::testFailure Failed asserting that 0 matches expected 1. /home/sb/EqualsTest.php:6 2) EqualsTest::testFailure2 Failed asserting that two strings are equal. --- Expected +++ Actual @@ @@ -'bar' +'baz' /home/sb/EqualsTest.php:11 3) EqualsTest::testFailure3 Failed asserting that two strings are equal. --- Expected +++ Actual @@ @@ 'foo -bar +bah baz ' /home/sb/EqualsTest.php:16 FAILURES! Tests: 3, Assertions: 3, Failures: 3. ~~~ 如果 `$expected` 和 `$actual` 是某些特定的類型，將使用更加專門的比較方式，參閱下文。 >[info] ## assertEquals(float $expected, float $actual[, string $message = '', float $delta = 0]) 當兩個浮點數 `$expected` 和 `$actual` 之間的差值（的絕對值）大于 `$delta` 時報告錯誤，錯誤訊息由 `$message` 指定。 關于為什么 `$delta` 參數是必須的，請閱讀《[關于浮點運算，每一位計算機科學從業人員都應該知道的事實](http://docs.oracle.com/cd/E19957-01/806-3568/ncg_goldberg.html)》。 **Example?A.14.?將assertEquals()用于浮點數時的用法** ~~~ <?php class EqualsTest extends PHPUnit_Framework_TestCase { public function testSuccess() { $this->assertEquals(1.0, 1.1, '', 0.2); } public function testFailure() { $this->assertEquals(1.0, 1.1); } } ?> ~~~ ~~~ phpunit EqualsTest PHPUnit 5.0.0 by Sebastian Bergmann and contributors. .F Time: 0 seconds, Memory: 5.75Mb There was 1 failure: 1) EqualsTest::testFailure Failed asserting that 1.1 matches expected 1.0. /home/sb/EqualsTest.php:11 FAILURES! Tests: 2, Assertions: 2, Failures: 1. ~~~ >[info] ## assertEquals(DOMDocument $expected, DOMDocument $actual[, string $message = '']) 當 `$expected` 和 `$actual` 這兩個 DOMDocument 對象所表示的 XML 文檔對應的無注釋規范形式不相同時報告錯誤，錯誤訊息由 `$message` 指定。 **Example?A.15.?assertEquals()應用于 DOMDocument 對象時的用法** ~~~ <?php class EqualsTest extends PHPUnit_Framework_TestCase { public function testFailure() { $expected = new DOMDocument; $expected->loadXML('<foo><bar/></foo>'); $actual = new DOMDocument; $actual->loadXML('<bar><foo/></bar>'); $this->assertEquals($expected, $actual); } } ?> ~~~ ~~~ phpunit EqualsTest PHPUnit 5.0.0 by Sebastian Bergmann and contributors. F Time: 0 seconds, Memory: 5.00Mb There was 1 failure: 1) EqualsTest::testFailure Failed asserting that two DOM documents are equal. --- Expected +++ Actual @@ @@ <?xml version="1.0"?> -<foo> - <bar/> -</foo> +<bar> + <foo/> +</bar> /home/sb/EqualsTest.php:12 FAILURES! Tests: 1, Assertions: 1, Failures: 1. ~~~ >[info] ## assertEquals(object $expected, object $actual[, string $message = '']) 當 `$expected` 和 `$actual` 這兩個對象的屬性值不相等時報告錯誤，錯誤訊息由 `$message` 指定。 **Example?A.16.?assertEquals()應用于對象時的用法** ~~~ <?php class EqualsTest extends PHPUnit_Framework_TestCase { public function testFailure() { $expected = new stdClass; $expected->foo = 'foo'; $expected->bar = 'bar'; $actual = new stdClass; $actual->foo = 'bar'; $actual->baz = 'bar'; $this->assertEquals($expected, $actual); } } ?> ~~~ ~~~ phpunit EqualsTest PHPUnit 5.0.0 by Sebastian Bergmann and contributors. F Time: 0 seconds, Memory: 5.25Mb There was 1 failure: 1) EqualsTest::testFailure Failed asserting that two objects are equal. --- Expected +++ Actual @@ @@ stdClass Object ( - 'foo' => 'foo' - 'bar' => 'bar' + 'foo' => 'bar' + 'baz' => 'bar' ) /home/sb/EqualsTest.php:14 FAILURES! Tests: 1, Assertions: 1, Failures: 1. ~~~ >[info] ## assertEquals(array $expected, array $actual[, string $message = '']) 當 `$expected` 和 `$actual` 這兩個數組不相等時報告錯誤，錯誤訊息由 `$message` 指定。 **Example?A.17.?assertEquals() 應用于數組時的用法** ~~~ <?php class EqualsTest extends PHPUnit_Framework_TestCase { public function testFailure() { $this->assertEquals(array('a', 'b', 'c'), array('a', 'c', 'd')); } } ?> ~~~ ~~~ phpunit EqualsTest PHPUnit 5.0.0 by Sebastian Bergmann and contributors. F Time: 0 seconds, Memory: 5.25Mb There was 1 failure: 1) EqualsTest::testFailure Failed asserting that two arrays are equal. --- Expected +++ Actual @@ @@ Array ( 0 => 'a' - 1 => 'b' - 2 => 'c' + 1 => 'c' + 2 => 'd' ) /home/sb/EqualsTest.php:6 FAILURES! Tests: 1, Assertions: 1, Failures: 1. ~~~