# assertContains() >[info] ## assertContains(mixed $needle, Iterator|array $haystack[, string $message = '']) 當 `$needle` 不是 `$haystack`的元素時報告錯誤，錯誤訊息由 `$message` 指定。 `assertNotContains()` 是與之相反的斷言，接受相同的參數。 `assertAttributeContains()` 和 `assertAttributeNotContains()` 是便捷包裝(convenience wrapper)，以某個類或對象的 `public`、`protected` 或 `private` 屬性為搜索范圍。 **Example?A.5.?assertContains() 的用法** ~~~ <?php class ContainsTest extends PHPUnit_Framework_TestCase { public function testFailure() { $this->assertContains(4, array(1, 2, 3)); } } ?> ~~~ ~~~ phpunit ContainsTest PHPUnit 5.0.0 by Sebastian Bergmann and contributors. F Time: 0 seconds, Memory: 5.00Mb There was 1 failure: 1) ContainsTest::testFailure Failed asserting that an array contains 4. /home/sb/ContainsTest.php:6 FAILURES! Tests: 1, Assertions: 1, Failures: 1. ~~~ >[info] ## assertContains(string $needle, string $haystack[, string $message = '', boolean $ignoreCase = FALSE]) 當 `$needle` 不是 `$haystack` 的子字符串時報告錯誤，錯誤訊息由 `$message` 指定。 如果 `$ignoreCase` 為 `TRUE`，測試將按大小寫不敏感的方式進行。 **Example?A.6.?assertContains() 的用法** ~~~ <?php class ContainsTest extends PHPUnit_Framework_TestCase { public function testFailure() { $this->assertContains('baz', 'foobar'); } } ?> ~~~ ~~~ phpunit ContainsTest PHPUnit 5.0.0 by Sebastian Bergmann and contributors. F Time: 0 seconds, Memory: 5.00Mb There was 1 failure: 1) ContainsTest::testFailure Failed asserting that 'foobar' contains "baz". /home/sb/ContainsTest.php:6 FAILURES! Tests: 1, Assertions: 1, Failures: 1. ~~~ **Example?A.7.?帶有 $ignoreCase 參數的 assertContains() 的用法** ~~~ <?php class ContainsTest extends PHPUnit_Framework_TestCase { public function testFailure() { $this->assertContains('foo', 'FooBar'); } public function testOK() { $this->assertContains('foo', 'FooBar', '', true); } } ?> ~~~ ~~~ phpunit ContainsTest PHPUnit 5.0.0 by Sebastian Bergmann and contributors. F. Time: 0 seconds, Memory: 2.75Mb There was 1 failure: 1) ContainsTest::testFailure Failed asserting that 'FooBar' contains "foo". /home/sb/ContainsTest.php:6 FAILURES! Tests: 2, Assertions: 2, Failures: 1. ~~~