Subversion-Projekte lars-tiefland.php_share

Revision

Details | Letzte Änderung | Log anzeigen | RSS feed

Revision Autor Zeilennr. Zeile
1 lars 1
<?php
2
/**
3
 * PHPUnit
4
 *
5
 * Copyright (c) 2002-2010, Sebastian Bergmann <sb@sebastian-bergmann.de>.
6
 * All rights reserved.
7
 *
8
 * Redistribution and use in source and binary forms, with or without
9
 * modification, are permitted provided that the following conditions
10
 * are met:
11
 *
12
 *   * Redistributions of source code must retain the above copyright
13
 *     notice, this list of conditions and the following disclaimer.
14
 *
15
 *   * Redistributions in binary form must reproduce the above copyright
16
 *     notice, this list of conditions and the following disclaimer in
17
 *     the documentation and/or other materials provided with the
18
 *     distribution.
19
 *
20
 *   * Neither the name of Sebastian Bergmann nor the names of his
21
 *     contributors may be used to endorse or promote products derived
22
 *     from this software without specific prior written permission.
23
 *
24
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
25
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
26
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
27
 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
28
 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
29
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
30
 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
31
 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
32
 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
33
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
34
 * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35
 * POSSIBILITY OF SUCH DAMAGE.
36
 *
37
 * @category   Testing
38
 * @package    PHPUnit
39
 * @author     Sebastian Bergmann <sb@sebastian-bergmann.de>
40
 * @copyright  2002-2010 Sebastian Bergmann <sb@sebastian-bergmann.de>
41
 * @license    http://www.opensource.org/licenses/bsd-license.php  BSD License
42
 * @link       http://www.phpunit.de/
43
 * @since      File available since Release 3.0.0
44
 */
45
 
46
require_once 'PHPUnit/Framework.php';
47
require_once 'PHPUnit/Util/Filter.php';
48
require_once 'PHPUnit/Util/Type.php';
49
 
50
PHPUnit_Util_Filter::addFileToFilter(__FILE__, 'PHPUNIT');
51
 
52
/**
53
 * Constraint that asserts that one value is identical to another.
54
 *
55
 * Identical check is performed with PHP's === operator, the operator is
56
 * explained in detail at
57
 * {@url http://www.php.net/manual/en/types.comparisons.php}.
58
 * Two values are identical if they have the same value and are of the same
59
 * type.
60
 *
61
 * The expected value is passed in the constructor.
62
 *
63
 * @category   Testing
64
 * @package    PHPUnit
65
 * @author     Sebastian Bergmann <sb@sebastian-bergmann.de>
66
 * @copyright  2002-2010 Sebastian Bergmann <sb@sebastian-bergmann.de>
67
 * @license    http://www.opensource.org/licenses/bsd-license.php  BSD License
68
 * @version    Release: 3.4.15
69
 * @link       http://www.phpunit.de/
70
 * @since      Class available since Release 3.0.0
71
 */
72
class PHPUnit_Framework_Constraint_IsIdentical extends PHPUnit_Framework_Constraint
73
{
74
    /**
75
     * @var mixed
76
     */
77
    protected $value;
78
 
79
    /**
80
     * @param mixed $value
81
     */
82
    public function __construct($value)
83
    {
84
        $this->value = $value;
85
    }
86
 
87
    /**
88
     * Evaluates the constraint for parameter $other. Returns TRUE if the
89
     * constraint is met, FALSE otherwise.
90
     *
91
     * @param mixed $other Value or object to evaluate.
92
     * @return bool
93
     */
94
    public function evaluate($other)
95
    {
96
        return $this->value === $other;
97
    }
98
 
99
    /**
100
     * @param   mixed   $other The value passed to evaluate() which failed the
101
     *                         constraint check.
102
     * @param   string  $description A string with extra description of what was
103
     *                               going on while the evaluation failed.
104
     * @param   boolean $not Flag to indicate negation.
105
     * @throws  PHPUnit_Framework_ExpectationFailedException
106
     */
107
    public function fail($other, $description, $not = FALSE)
108
    {
109
        $failureDescription = $this->failureDescription(
110
          $other,
111
          $description,
112
          $not
113
        );
114
 
115
        if (!$not) {
116
            throw new PHPUnit_Framework_ExpectationFailedException(
117
              $failureDescription,
118
              PHPUnit_Framework_ComparisonFailure::diffIdentical(
119
                $this->value, $other
120
              ),
121
              $description
122
            );
123
        } else {
124
            throw new PHPUnit_Framework_ExpectationFailedException(
125
              $failureDescription,
126
              NULL
127
            );
128
        }
129
    }
130
 
131
    /**
132
     * Returns a string representation of the constraint.
133
     *
134
     * @return string
135
     */
136
    public function toString()
137
    {
138
        if (is_object($this->value)) {
139
            return 'is identical to an object of class "' .
140
                   get_class($this->value) . '"';
141
        } else {
142
            return 'is identical to ' .
143
                   PHPUnit_Util_Type::toString($this->value);
144
        }
145
    }
146
}
147
?>