Class ContentsContainRow

__construct(array<string> $contents, string $output)

Конструктор

Параметры

additionalFailureDescription(mixed $other): string

Возвращает дополнительное описание ошибки, если необходимо.

Функция может быть переопределена для предоставления дополнительной информации об ошибке, например, diff.

Параметры

Возвращает

count(): int

Подсчитывает количество элементов ограничения.

Возвращает

evaluate(mixed $other, string $description = '', bool $returnResult = false): ?bool

Вычисляет ограничение для параметра $other.

Если $returnResult установлен в false (по умолчанию), при ошибке выбрасывается исключение. В противном случае возвращается null.

Если $returnResult установлен в true, результат вычисления возвращается как логическое значение: true в случае успеха, false в случае ошибки.

Параметры

Возвращает

Выбрасывает

exporter(): Exporter

Возвращает

fail(mixed $other, string $description, ComparisonFailure $comparisonFailure = null): void

Выбрасывает исключение для данного сравниваемого значения и описания теста.

Параметры

Возвращает

Выбрасывает

failureDescription(mixed $other): string

Возвращает описание ошибки.

Начало сообщений об ошибках, как правило, «Failed asserting that». Этот метод должен возвращать вторую часть этого предложения.

Для предоставления дополнительной информации об ошибке можно использовать additionalFailureDescription.

Параметры

Возвращает

failureDescriptionInContext(Operator $operator, mixed $role, mixed $other): string

Возвращает описание ошибки в контексте выражения $operator.

Цель этого метода — предоставить осмысленное описание ошибки в контексте операторов, таких как LogicalNot. Стандартные ограничения PHPUnit поддерживаются LogicalNot «из коробки», но внешние ограничения не имели возможности предоставить правильные сообщения в этом контексте.

Метод должен возвращать пустую строку, если сам не обрабатывает настройку.

Параметры

Возвращает

matches(mixed $other): bool

Проверяет, содержит ли содержимое ожидаемое.

Этот метод может быть переопределен для реализации алгоритма вычисления.

Параметры

Возвращает

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
    • -

вырожденное. Вызов reduce() на объекте LogicalOr выше, а также на LogicalAnd, должен вернуть экземпляр IsType('int').

Можно реализовать другие конкретные сокращения, например, каскад операторов LogicalNot

• LogicalNot
  • LogicalNot +LogicalNot
    • IsTrue

можно свести к

LogicalNot

• IsTrue

Возвращает

toString(): string

Сообщение проверки

Возвращает

toStringInContext(Operator $operator, mixed $role): string

Возвращает пользовательское строковое представление объекта ограничения, когда он появляется в контексте выражения $operator.

Цель этого метода — предоставить осмысленную описательную строку в контексте операторов, таких как LogicalNot. Стандартные ограничения PHPUnit поддерживаются LogicalNot «из коробки», но внешние ограничения не имели возможности предоставить правильные строки в этом контексте.

Метод должен возвращать пустую строку, если сам не обрабатывает настройку.

Параметры

Возвращает