assertContains()


assertContains(mixed $needle, Iterator|array $haystack[, string $message = ''])

当 $needle 不是 $haystack的元素时报告错误，错误讯息由 $message 指定。

assertNotContains() 是与之相反的断言，接受相同的参数。

assertAttributeContains() 和 assertAttributeNotContains() 是便捷包装(convenience wrapper)，以某个类或对象的 public、protected 或 private 属性为搜索范围。


例 A.5: assertContains() 的用法

  1. <?php
  2. class ContainsTest extends PHPUnit_Framework_TestCase
  3. {
  4.     public function testFailure()
  5.     {
  6.         $this->assertContains(4, array(1, 2, 3));
  7.     }
  8. }
  9. ?>
  1. phpunit ContainsTest
  2. PHPUnit 4.8.0 by Sebastian Bergmann and contributors.
  3.  
  4. F
  5.  
  6. Time: 0 seconds, Memory: 5.00Mb
  7.  
  8. There was 1 failure:
  9.  
  10. 1) ContainsTest::testFailure
  11. Failed asserting that an array contains 4.
  12.  
  13. /home/sb/ContainsTest.php:6
  14.  
  15. FAILURES!
  16. Tests: 1, Assertions: 1, Failures: 1.

assertContains(string $needle, string $haystack[, string $message = '', boolean $ignoreCase = FALSE])

当 $needle 不是 $haystack 的子字符串时报告错误，错误讯息由 $message 指定。

如果 $ignoreCase 为 TRUE，测试将按大小写不敏感的方式进行。


例 A.6: assertContains() 的用法

  1. <?php
  2. class ContainsTest extends PHPUnit_Framework_TestCase
  3. {
  4.     public function testFailure()
  5.     {
  6.         $this->assertContains('baz', 'foobar');
  7.     }
  8. }
  9. ?>
  1. phpunit ContainsTest
  2. PHPUnit 4.8.0 by Sebastian Bergmann and contributors.
  3.  
  4. F
  5.  
  6. Time: 0 seconds, Memory: 5.00Mb
  7.  
  8. There was 1 failure:
  9.  
  10. 1) ContainsTest::testFailure
  11. Failed asserting that 'foobar' contains "baz".
  12.  
  13. /home/sb/ContainsTest.php:6
  14.  
  15. FAILURES!
  16. Tests: 1, Assertions: 1, Failures: 1.


例 A.7: 带有 $ignoreCase 参数的 assertContains() 的用法

  1. <?php
  2. class ContainsTest extends PHPUnit_Framework_TestCase
  3. {
  4.     public function testFailure()
  5.     {
  6.         $this->assertContains('foo', 'FooBar');
  7.     }
  8.  
  9.     public function testOK()
  10.     {
  11.         $this->assertContains('foo', 'FooBar', '', true);
  12.     }
  13. }
  14. ?>
  1. phpunit ContainsTest
  2. PHPUnit 4.8.0 by Sebastian Bergmann and contributors.
  3.  
  4. F.
  5.  
  6. Time: 0 seconds, Memory: 2.75Mb
  7.  
  8. There was 1 failure:
  9.  
  10. 1) ContainsTest::testFailure
  11. Failed asserting that 'FooBar' contains "foo".
  12.  
  13. /home/sb/ContainsTest.php:6
  14.  
  15. FAILURES!
  16. Tests: 2, Assertions: 2, Failures: 1.