Класс MailSubjectContains

__construct(int|null $at = null): void

Конструктор

Параметры

Возвращает

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, но внешние разработчики не имели возможности предоставить правильные сообщения в этом контексте.

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

Параметры

Возвращает

getAssertedMessages(): string

Возвращает субъекты всех сообщений, учитывая $this->at

Возвращает

getMessages(): Cake\Mailer\Message[]

Получает электронную почту или электронные письма для проверки

Возвращает

matches(mixed $other): bool

Проверка ограничения

Этот метод можно переопределить для реализации алгоритма оценки.

Параметры

Возвращает

reduce(): self

Упрощает подвыражение, начиная с $this, пропускает вырожденные подвыражения и возвращает первое дочернее ограничение, которое начинает не упрощаемое подвыражение.

Возвращает $this для конечных ограничений и для операторов, которые начинают не упрощаемое подвыражение, или ближайшее дочернее ограничение $this, которое начинает не упрощаемое подвыражение.

Выражение ограничения можно моделировать как дерево с нетерминальными узлами (операторы) и терминальными узлами. Например:

LogicalOr (оператор, нетерминал)

• LogicalAnd (оператор, нетерминал) | + IsType('int') (терминал) | + GreaterThan(10) (терминал)
• LogicalNot (оператор, нетерминал)
  • IsType('array') (терминал)

Вырожденное подвыражение — это часть дерева, которая фактически не влияет на оценку выражения, в котором она появляется. Примером вырожденного подвыражения является BinaryOperator, построенный с одним операндом или вложенными BinaryOperators, каждый с одним операндом. Выражение, включающее вырожденное подвыражение, эквивалентно упрощенному выражению с удаленным вырожденным подвыражением, например

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, но внешние разработчики не имели возможности предоставить правильные строки в этом контексте.

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

Параметры

Возвращает