Class ContentsNotContain
ContentsNotContain
Краткое описание методов
-
__construct() public
Конструктор
-
additionalFailureDescription() protected
Возвращает дополнительное описание ошибки, если нужно.
-
count() public
Считает количество элементов ограничения.
-
evaluate() public
Вычисляет ограничение для параметра $other.
-
exporter() protected
-
fail() protected
Выбрасывает исключение для заданного сравниваемого значения и описания теста.
-
failureDescription() protected
Возвращает описание ошибки.
-
failureDescriptionInContext() protected
Возвращает описание ошибки, когда это ограничение появляется в контексте выражения $operator.
-
matches() public
Проверяет, содержит ли содержимое ожидаемое.
-
reduce() protected
Уменьшает подвыражение, начинающееся с $this, пропуская вырожденные подвыражения, и возвращает первое ограничение потомка, которое начинается с несокращаемого подвыражения.
-
toString() public
Сообщение об утверждении
-
toStringInContext() protected
Возвращает пользовательское строковое представление объекта ограничения, когда он появляется в контексте выражения $operator.
Подробное описание методов
__construct() public
__construct(array<string> $contents, string $output)
Конструктор
Параметры
-
array<string>$contents Содержание
-
string$output Тип вывода
additionalFailureDescription() protected
additionalFailureDescription(mixed $other): string
Возвращает дополнительное описание ошибки, если необходимо.
Функция может быть переопределена для предоставления дополнительной информации об ошибке, например, разницу.
Параметры
-
mixed$other оцениваемое значение или объект
Возвращает
stringcount() public
count(): int
Считает количество элементов ограничения.
Возвращает
intevaluate() public
evaluate(mixed $other, string $description = '', bool $returnResult = false): ?bool
Оценивает ограничение для параметра $other.
Если $returnResult установлен в false (по умолчанию), в случае ошибки выбрасывается исключение. В противном случае возвращается null.
Если $returnResult установлен в true, результат оценки возвращается в виде логического значения: true в случае успеха, false в случае ошибки.
Параметры
- $other
-
string$description необязательно -
bool$returnResult необязательно
Возвращает
?boolВыбрасывает
SebastianBergmann\RecursionContext\InvalidArgumentExceptionExpectationFailedExceptionexporter() protected
exporter(): Exporter
Возвращает
Exporterfail() protected
fail(mixed $other, string $description, ComparisonFailure $comparisonFailure = null): void
Выбрасывает исключение для данного сравниваемого значения и описания теста.
Параметры
-
mixed$other оцениваемое значение или объект
-
string$description Дополнительная информация о тесте
-
ComparisonFailure$comparisonFailure необязательно
Возвращает
voidВыбрасывает
SebastianBergmann\RecursionContext\InvalidArgumentExceptionExpectationFailedExceptionfailureDescription() protected
failureDescription(mixed $other): string
Возвращает описание ошибки.
В большинстве случаев начало сообщений об ошибках — "Не удалось утверждать, что". Этот метод должен возвращать вторую часть этого предложения.
Для предоставления дополнительной информации об ошибке можно использовать additionalFailureDescription.
Параметры
-
mixed$other оцениваемое значение или объект
Возвращает
stringВыбрасывает
SebastianBergmann\RecursionContext\InvalidArgumentExceptionfailureDescriptionInContext() protected
failureDescriptionInContext(Operator $operator, mixed $role, mixed $other): string
Возвращает описание ошибки в контексте выражения $operator.
Цель этого метода — предоставить осмысленное описание ошибки в контексте операторов, таких как LogicalNot. Встроенные ограничения PHPUnit поддерживаются LogicalNot по умолчанию, но внешние разработанные не имели возможности предоставлять правильные сообщения в этом контексте.
Метод должен возвращать пустую строку, если сам по себе не обрабатывает настройку.
Параметры
-
Operator$operator оператор $operator выражения
-
mixed$role роль ограничения $this в выражении $operator
-
mixed$other оцениваемое значение или объект
Возвращает
stringmatches() public
matches(mixed $other): bool
Проверяет, содержит ли содержимое ожидаемое.
Этот метод может быть переопределен для реализации алгоритма оценки.
Параметры
-
mixed$other Ожидаемое
Возвращает
boolreduce() protected
reduce(): self
Редуцирует подвыражение, начинающееся с $this, пропуская вырожденные подвыражения и возвращает первое ограничение-потомок, которое начинает нередуцируемое подвыражение.
Возвращает $this для терминальных ограничений и для операторов, которые начинают нередуцируемые подвыражения, или ближайшего потомка $this, который начинает нередуцируемое подвыражение.
Выражение ограничения может быть смоделировано как дерево с нетерминальными узлами (операторами) и терминальными узлами. Например:
LogicalOr (оператор, нетерминал)
- LogicalAnd (оператор, нетерминал) | + IsType('int') (терминал) | + GreaterThan(10) (терминал)
- LogicalNot (оператор, нетерминал)
- IsType('array') (терминал)
Вырожденное подвыражение — это часть дерева, которая фактически не вносит вклад в оценку выражения, в котором она появляется. Примером вырожденного подвыражения является BinaryOperator, созданный с одним операндом или вложенными BinaryOperator, каждый с одним операндом. Выражение, включающее вырожденное подвыражение, эквивалентно редуцированному выражению с удаленным вырожденным подвыражением, например
LogicalAnd (оператор)
- LogicalOr (вырожденный оператор) | + LogicalAnd (вырожденный оператор) | + IsType('int') (терминал)
- GreaterThan(10) (терминал)
эквивалентно
LogicalAnd (оператор)
- IsType('int') (терминал)
- GreaterThan(10) (терминал)
потому что подвыражение
- LogicalOr
- LogicalAnd
- -
- LogicalAnd
является вырожденным. Вызов reduce() для объекта LogicalOr, а также LogicalAnd, должен вернуть экземпляр IsType('int').
Можно реализовать другие конкретные сокращения, например, каскад операторов LogicalNot
- LogicalNot
- LogicalNot +LogicalNot
- IsTrue
- LogicalNot +LogicalNot
можно сократить до
LogicalNot
- IsTrue
Возвращает
selftoString() public
toString(): string
Сообщение утверждения
Возвращает
stringtoStringInContext() protected
toStringInContext(Operator $operator, mixed $role): string
Возвращает пользовательское строковое представление объекта ограничения, когда он появляется в контексте выражения $operator.
Цель этого метода — предоставить осмысленную описательную строку в контексте операторов, таких как LogicalNot. Встроенные ограничения PHPUnit поддерживаются LogicalNot по умолчанию, но внешние разработанные не имели возможности предоставлять правильные строки в этом контексте.
Метод должен возвращать пустую строку, если сам по себе не обрабатывает настройку.
Параметры
-
Operator$operator оператор $operator выражения
-
mixed$role роль ограничения $this в выражении $operator
Возвращает
stringПодробное описание свойств
$contents protected
Тип
string$output protected
Тип
string
© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/4.4/class-Cake.Console.TestSuite.Constraint.ContentsNotContain.html