assertStringMatchesFormat()

assertStringMatchesFormat()

assertStringMatchesFormat(string $format, string $string[, string $message = ''])

当 $string 不匹配于 $format 定义的格式时报告错误，错误讯息由 $message 指定。

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

Example A.35. assertStringMatchesFormat() 的用法

<?php
class StringMatchesFormatTest extends PHPUnit_Framework_TestCase
{
    public function testFailure()
    {
        $this->assertStringMatchesFormat('%i', 'foo');
    }
}
?>

phpunit StringMatchesFormatTest

PHPUnit 5.0.0 by Sebastian Bergmann and contributors.

F

Time: 0 seconds, Memory: 5.00Mb

There was 1 failure:

1) StringMatchesFormatTest::testFailure
Failed asserting that 'foo' matches PCRE pattern "/^[+-]?\d+$/s".

/home/sb/StringMatchesFormatTest.php:6

FAILURES!
Tests: 1, Assertions: 1, Failures: 1.

格式定义字符串中可以使用如下占位符：

• %e：表示目录分隔符，例如在 Linux 系统中是 /。

• %s：一个或多个除了换行符以外的任意字符（非空白字符或者空白字符）。

• %S：零个或多个除了换行符以外的任意字符（非空白字符或者空白字符）。

• %a：一个或多个包括换行符在内的任意字符（非空白字符或者空白字符）。

• %A：零个或多个包括换行符在内的任意字符（非空白字符或者空白字符）。

• %w：零个或多个空白字符。

• %i：带符号整数值，例如 +3142、-3142。

• %d：无符号整数值，例如 123456。

• %x：一个或多个十六进制字符。所谓十六进制字符，指的是在以下范围内的字符：0-9、a-f、A-F。

• %f：浮点数，例如 3.142、-3.142、3.142E-10、3.142e+10。

• %c：单个任意字符。