abstract class AbstractKsortedConstraint extends Constraint implements ComparatorWrapperInterface

Abstract base class for constraints that compare key-sorted arrays.

Traits

Methods

string
toString()

Returns a string representation of the constraint.

string
failureDescription(mixed $other)

Returns the description of the failure.

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

Returns the description of the failure when this constraint appears in context of an $operator expression.

string
toStringInContext(Operator $operator, mixed $role)

Returns a custom string representation of the constraint object when it appears in context of an $operator expression.

__construct(ComparatorInterface $comparator, array $expected, int $flags)

No description

getComparator()

Returns an instance of ComparatorInterface which implements comparison operator.

bool|null
evaluate(mixed $other, string $description = '', bool $returnResult = false)

Evaluates the constraint for parameter $other.

array
ksorted(array $array)

Returns key-sorted copy of $array.

bool
matches(mixed $other)

Evaluates the constraint for parameter $other. Returns true if the constraint is met, false otherwise.

bool
supports(mixed $other)

No description

Details

at line 65
final string toString()

Returns a string representation of the constraint.

Return Value

string

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.

Parameters

mixed $other

evaluated value or object

Return Value

string

Exceptions

InvalidArgumentException

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.

Parameters

Operator $operator

the $operator of the expression

mixed $role

role of $this constraint in the $operator expression

mixed $other

evaluated value or object

Return Value

string

Exceptions

InvalidArgumentException

at line 142
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.

Parameters

Operator $operator

the $operator of the expression

mixed $role

role of $this constraint in the $operator expression

Return Value

string

at line 47
final protected __construct(ComparatorInterface $comparator, array $expected, int $flags)

No description

Parameters

ComparatorInterface $comparator
array $expected
int $flags

at line 57
final ComparatorInterface getComparator()

Returns an instance of ComparatorInterface which implements comparison operator.

Return Value

ComparatorInterface

at line 91
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.

Parameters

mixed $other
string $description
bool $returnResult

Return Value

bool|null

Exceptions

ExpectationFailedException
InvalidArgumentException
CircularDependencyException

at line 120
final array ksorted(array $array)

Returns key-sorted copy of $array.

Parameters

array $array

Return Value

array

at line 160
final protected bool matches(mixed $other)

Evaluates the constraint for parameter $other. Returns true if the constraint is met, false otherwise.

Parameters

mixed $other

value or object to evaluate

Return Value

bool

at line 174
final protected bool supports(mixed $other)

No description

Parameters

mixed $other

value or object to evaluate

Return Value

bool