1. class
  2. PHPUnit
  3. \
  4. Framework
  5. \
  6. Constraint
  7. \
  8. ArraySubset

ArraySubset

class ArraySubset extends Constraint (View source)

Constraint that asserts that the array it is evaluated for has a specified subset.

Uses array_replace_recursive() to check if a key value subset is part of the subject array.

Properties

protected $exporter from Constraint
protected array|Traversable $subset
protected bool $strict

Methods

__construct(array|Traversable $subset, bool $strict = false)

No description

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

Evaluates the constraint for parameter $other

bool
matches(mixed $other)

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

from Constraint
int
count()

Counts the number of constraint elements.

from Constraint
fail(mixed $other, string $description, ComparisonFailure $comparisonFailure = null)

Throws an exception for the given compared value and test description

from Constraint
string
additionalFailureDescription(mixed $other)

Return additional failure description where needed

from Constraint
string
failureDescription(mixed $other)

Returns the description of the failure

string
toString()

Returns a string representation of the constraint.

Details

at line 37
__construct(array|Traversable $subset, bool $strict = false)

Parameters

array|Traversable $subset
bool $strict Check for object identity

at line 63
mixed 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 Value or object to evaluate.
string $description Additional information about the test
bool $returnResult Whether to return a result or throw an exception

Return Value

mixed

Exceptions

ExpectationFailedException

in Constraint at line 76
protected bool matches(mixed $other)

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

This method can be overridden to implement the evaluation algorithm.

Parameters

mixed $other Value or object to evaluate.

Return Value

bool

in Constraint at line 86
int count()

Counts the number of constraint elements.

Return Value

int

in Constraint at line 100
protected fail(mixed $other, string $description, ComparisonFailure $comparisonFailure = null)

Throws an exception for the given compared value and test description

Parameters

mixed $other Evaluated value or object.
string $description Additional information about the test
ComparisonFailure $comparisonFailure

Exceptions

ExpectationFailedException

in Constraint at line 133
protected string additionalFailureDescription(mixed $other)

Return additional failure description where needed

The function can be overridden to provide additional failure information like a diff

Parameters

mixed $other Evaluated value or object.

Return Value

string

at line 114
protected 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

at line 99
string toString()

Returns a string representation of the constraint.

Return Value

string