final class KsortedArrayEqualTo extends AbstractKsortedConstraint

Constraint that accepts arrays equal to specified one when key-sorted.

The == operator (equality) is used for comparison.

$matcher = KsortedArrayEqualTo::create([ 'name' => 'John', 'age' => '21' ]);

self::assertThat([ 'age' => 21, 'name' => 'John', ], $matcher);

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.

Exporter
exporter()

No description

__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

create(array $expected, int $flags = SORT_REGULAR)

No description

Details

abstract 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

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

abstract 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

abstract protected Exporter exporter()

No description

Return Value

Exporter

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

No description

Parameters

ComparatorInterface $comparator
array $expected
int $flags

final ComparatorInterface getComparator()

Returns an instance of ComparatorInterface which implements comparison operator.

Return Value

ComparatorInterface

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

final array ksorted(array $array)

Returns key-sorted copy of $array.

Parameters

array $array

Return Value

array

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

final protected bool supports(mixed $other)

No description

Parameters

mixed $other

value or object to evaluate

Return Value

bool

at line 33
static KsortedArrayEqualTo create(array $expected, int $flags = SORT_REGULAR)

No description

Parameters

array $expected
int $flags

Return Value

KsortedArrayEqualTo