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

IsIdentical

class IsIdentical extends Constraint (View source)

Constraint that asserts that one value is identical to another.

Identical check is performed with PHP's === operator, the operator is explained in detail at {@url http://www.php.net/manual/en/types.comparisons.php}. Two values are identical if they have the same value and are of the same type.

The expected value is passed in the constructor.

Constants

EPSILON

Properties

protected $exporter from Constraint
protected mixed $value

Methods

__construct(mixed $value)

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 41
__construct(mixed $value)

Parameters

mixed $value

at line 65
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 106
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 124
string toString()

Returns a string representation of the constraint.

Return Value

string