AbstractConstraint
abstract class AbstractConstraint extends Constraint implements ComparatorWrapperInterface, SelectionWrapperInterface
| internal | This class is not covered by the backward compatibility promise |
Abstract base for constraints that examine values.
Traits
Methods
Returns a string representation of the constraint.
Returns the description of the failure.
Returns the description of the failure when this constraint appears in context of an $operator expression.
Returns a custom string representation of the constraint object when it appears in context of an $operator expression.
No description
No description
Returns an instance of SelectionInterface which defines expected values.
Returns an instance of ComparatorInterface which implements comparison operator.
Evaluates the constraint for parameter $other.
Evaluates the constraint for parameter $other. Returns true if the constraint is met, false otherwise.
Details
at line 84
final string
toString()
Returns a string representation of the constraint.
in
ShortFailureDescriptionTrait at line 36
final string
failureDescription(mixed $other)
Returns the description of the failure.
The beginning of failure messages is "Failed asserting that" in most cases. This method should return the second part of that sentence.
in
ShortFailureDescriptionTrait at line 57
final string
failureDescriptionInContext(Operator $operator, mixed $role, mixed $other)
Returns the description of the failure when this constraint appears in context of an $operator expression.
The purpose of this method is to provide meaningful failue description in context of operators such as LogicalNot. Native PHPUnit constraints are supported out of the box by LogicalNot, but externally developed ones had no way to provide correct messages in this context.
The method shall return empty string, when it does not handle customization by itself.
at line 154
final protected string
toStringInContext(Operator $operator, mixed $role)
Returns a custom string representation of the constraint object when it appears in context of an $operator expression.
The purpose of this method is to provide meaningful descriptive string in context of operators such as LogicalNot. Native PHPUnit constraints are supported out of the box by LogicalNot, but externally developed ones had no way to provide correct strings in this context.
The method shall return empty string, when it does not handle customization by itself.
at line 185
final protected Exporter
exporter()
No description
at line 55
final protected
__construct(ComparatorInterface $comparator, SelectionInterface $expected, RecursiveUnwrapperInterface $unwrapper)
No description
at line 68
final SelectionInterface
getSelection()
Returns an instance of SelectionInterface which defines expected values.
at line 76
final ComparatorInterface
getComparator()
Returns an instance of ComparatorInterface which implements comparison operator.
at line 112
final bool|null
evaluate(mixed $other, string $description = '', bool $returnResult = false)
Evaluates the constraint for parameter $other.
If $returnResult is set to false (the default), an exception is thrown in case of a failure. null is returned otherwise.
If $returnResult is true, the result of the evaluation is returned as a boolean value instead: true in case of success, false in case of a failure.
at line 174
final protected bool
matches(mixed $other)
Evaluates the constraint for parameter $other. Returns true if the constraint is met, false otherwise.