<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="content-type" content="text/html; charset=UTF-8"> <title>Comparing objects</title> </head> <body><div class="manualnavbar" style="text-align: center;"> <div class="prev" style="text-align: left; float: left;"><a href="oop4.newref.html">References inside the constructor</a></div> <div class="next" style="text-align: right; float: right;"><a href="debugger.html">Debugging in PHP</a></div> <div class="up"><a href="oop4.html">Classes and Objects (PHP 4)</a></div> <div class="home"><a href="index.html">PHP Manual</a></div> </div><hr /><div id="oop4.object-comparison" class="sect1"> <h2 class="title">Comparing objects</h2> <p class="para"> In PHP 4, objects are compared in a very simple manner, namely: Two object instances are equal if they have the same attributes and values, and are instances of the same class. Similar rules are applied when comparing two objects using the identity operator (<em>===</em>). </p> <p class="para"> If we were to execute the code in the example below: <div class="example" id="example-5623"> <p><strong>Example #1 Example of object comparison in PHP 4</strong></p> <div class="example-contents"> <div class="phpcode"><code><span style="color: #000000"> <span style="color: #0000BB"><?php<br /></span><span style="color: #007700">function </span><span style="color: #0000BB">bool2str</span><span style="color: #007700">(</span><span style="color: #0000BB">$bool</span><span style="color: #007700">) {<br /> if (</span><span style="color: #0000BB">$bool </span><span style="color: #007700">=== </span><span style="color: #0000BB">false</span><span style="color: #007700">) {<br /> return </span><span style="color: #DD0000">'FALSE'</span><span style="color: #007700">;<br /> } else {<br /> return </span><span style="color: #DD0000">'TRUE'</span><span style="color: #007700">;<br /> }<br />}<br /><br />function </span><span style="color: #0000BB">compareObjects</span><span style="color: #007700">(&</span><span style="color: #0000BB">$o1</span><span style="color: #007700">, &</span><span style="color: #0000BB">$o2</span><span style="color: #007700">) {<br /> echo </span><span style="color: #DD0000">'o1 == o2 : '</span><span style="color: #007700">.</span><span style="color: #0000BB">bool2str</span><span style="color: #007700">(</span><span style="color: #0000BB">$o1 </span><span style="color: #007700">== </span><span style="color: #0000BB">$o2</span><span style="color: #007700">).</span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br /> echo </span><span style="color: #DD0000">'o1 != o2 : '</span><span style="color: #007700">.</span><span style="color: #0000BB">bool2str</span><span style="color: #007700">(</span><span style="color: #0000BB">$o1 </span><span style="color: #007700">!= </span><span style="color: #0000BB">$o2</span><span style="color: #007700">).</span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br /> echo </span><span style="color: #DD0000">'o1 === o2 : '</span><span style="color: #007700">.</span><span style="color: #0000BB">bool2str</span><span style="color: #007700">(</span><span style="color: #0000BB">$o1 </span><span style="color: #007700">=== </span><span style="color: #0000BB">$o2</span><span style="color: #007700">).</span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br /> echo </span><span style="color: #DD0000">'o1 !== o2 : '</span><span style="color: #007700">.</span><span style="color: #0000BB">bool2str</span><span style="color: #007700">(</span><span style="color: #0000BB">$o1 </span><span style="color: #007700">!== </span><span style="color: #0000BB">$o2</span><span style="color: #007700">).</span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />}<br /><br />class </span><span style="color: #0000BB">Flag </span><span style="color: #007700">{<br /> var </span><span style="color: #0000BB">$flag</span><span style="color: #007700">;<br /><br /> function </span><span style="color: #0000BB">Flag</span><span style="color: #007700">(</span><span style="color: #0000BB">$flag</span><span style="color: #007700">=</span><span style="color: #0000BB">true</span><span style="color: #007700">) {<br /> </span><span style="color: #0000BB">$this</span><span style="color: #007700">-></span><span style="color: #0000BB">flag </span><span style="color: #007700">= </span><span style="color: #0000BB">$flag</span><span style="color: #007700">;<br /> }<br />}<br /><br />class </span><span style="color: #0000BB">SwitchableFlag </span><span style="color: #007700">extends </span><span style="color: #0000BB">Flag </span><span style="color: #007700">{<br /><br /> function </span><span style="color: #0000BB">turnOn</span><span style="color: #007700">() {<br /> </span><span style="color: #0000BB">$this</span><span style="color: #007700">-></span><span style="color: #0000BB">flag </span><span style="color: #007700">= </span><span style="color: #0000BB">true</span><span style="color: #007700">;<br /> }<br /><br /> function </span><span style="color: #0000BB">turnOff</span><span style="color: #007700">() {<br /> </span><span style="color: #0000BB">$this</span><span style="color: #007700">-></span><span style="color: #0000BB">flag </span><span style="color: #007700">= </span><span style="color: #0000BB">false</span><span style="color: #007700">;<br /> }<br />}<br /><br /></span><span style="color: #0000BB">$o </span><span style="color: #007700">= new </span><span style="color: #0000BB">Flag</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">$p </span><span style="color: #007700">= new </span><span style="color: #0000BB">Flag</span><span style="color: #007700">(</span><span style="color: #0000BB">false</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$q </span><span style="color: #007700">= new </span><span style="color: #0000BB">Flag</span><span style="color: #007700">();<br /><br /></span><span style="color: #0000BB">$r </span><span style="color: #007700">= new </span><span style="color: #0000BB">SwitchableFlag</span><span style="color: #007700">();<br /><br />echo </span><span style="color: #DD0000">"Compare instances created with the same parameters\n"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">compareObjects</span><span style="color: #007700">(</span><span style="color: #0000BB">$o</span><span style="color: #007700">, </span><span style="color: #0000BB">$q</span><span style="color: #007700">);<br /><br />echo </span><span style="color: #DD0000">"\nCompare instances created with different parameters\n"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">compareObjects</span><span style="color: #007700">(</span><span style="color: #0000BB">$o</span><span style="color: #007700">, </span><span style="color: #0000BB">$p</span><span style="color: #007700">);<br /><br />echo </span><span style="color: #DD0000">"\nCompare an instance of a parent class with one from a subclass\n"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">compareObjects</span><span style="color: #007700">(</span><span style="color: #0000BB">$o</span><span style="color: #007700">, </span><span style="color: #0000BB">$r</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?></span> </span> </code></div> </div> <div class="example-contents"><p>The above example will output:</p></div> <div class="example-contents screen"> <div class="cdata"><pre> Compare instances created with the same parameters o1 == o2 : TRUE o1 != o2 : FALSE o1 === o2 : TRUE o1 !== o2 : FALSE Compare instances created with different parameters o1 == o2 : FALSE o1 != o2 : TRUE o1 === o2 : FALSE o1 !== o2 : TRUE Compare an instance of a parent class with one from a subclass o1 == o2 : FALSE o1 != o2 : TRUE o1 === o2 : FALSE o1 !== o2 : TRUE </pre></div> </div> </div> Which is the output we will expect to obtain given the comparison rules above. Only instances with the same values for their attributes and from the same class are considered equal and identical. </p> <p class="para"> Even in the cases where we have object composition, the same comparison rules apply. In the example below we create a container class that stores an associative array of <strong class="classname">Flag</strong> objects. <div class="example" id="example-5624"> <p><strong>Example #2 Compound object comparisons in PHP 4</strong></p> <div class="example-contents"> <div class="phpcode"><code><span style="color: #000000"> <span style="color: #0000BB"><?php<br /></span><span style="color: #007700">class </span><span style="color: #0000BB">FlagSet </span><span style="color: #007700">{<br /> var </span><span style="color: #0000BB">$set</span><span style="color: #007700">;<br /><br /> function </span><span style="color: #0000BB">FlagSet</span><span style="color: #007700">(</span><span style="color: #0000BB">$flagArr </span><span style="color: #007700">= array()) {<br /> </span><span style="color: #0000BB">$this</span><span style="color: #007700">-></span><span style="color: #0000BB">set </span><span style="color: #007700">= </span><span style="color: #0000BB">$flagArr</span><span style="color: #007700">;<br /> }<br /><br /> function </span><span style="color: #0000BB">addFlag</span><span style="color: #007700">(</span><span style="color: #0000BB">$name</span><span style="color: #007700">, </span><span style="color: #0000BB">$flag</span><span style="color: #007700">) {<br /> </span><span style="color: #0000BB">$this</span><span style="color: #007700">-></span><span style="color: #0000BB">set</span><span style="color: #007700">[</span><span style="color: #0000BB">$name</span><span style="color: #007700">] = </span><span style="color: #0000BB">$flag</span><span style="color: #007700">;<br /> }<br /><br /> function </span><span style="color: #0000BB">removeFlag</span><span style="color: #007700">(</span><span style="color: #0000BB">$name</span><span style="color: #007700">) {<br /> if (</span><span style="color: #0000BB">array_key_exists</span><span style="color: #007700">(</span><span style="color: #0000BB">$name</span><span style="color: #007700">, </span><span style="color: #0000BB">$this</span><span style="color: #007700">-></span><span style="color: #0000BB">set</span><span style="color: #007700">)) {<br /> unset(</span><span style="color: #0000BB">$this</span><span style="color: #007700">-></span><span style="color: #0000BB">set</span><span style="color: #007700">[</span><span style="color: #0000BB">$name</span><span style="color: #007700">]);<br /> }<br /> }<br />}<br /><br /><br /></span><span style="color: #0000BB">$u </span><span style="color: #007700">= new </span><span style="color: #0000BB">FlagSet</span><span style="color: #007700">();<br /></span><span style="color: #0000BB">$u</span><span style="color: #007700">-></span><span style="color: #0000BB">addFlag</span><span style="color: #007700">(</span><span style="color: #DD0000">'flag1'</span><span style="color: #007700">, </span><span style="color: #0000BB">$o</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$u</span><span style="color: #007700">-></span><span style="color: #0000BB">addFlag</span><span style="color: #007700">(</span><span style="color: #DD0000">'flag2'</span><span style="color: #007700">, </span><span style="color: #0000BB">$p</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$v </span><span style="color: #007700">= new </span><span style="color: #0000BB">FlagSet</span><span style="color: #007700">(array(</span><span style="color: #DD0000">'flag1'</span><span style="color: #007700">=></span><span style="color: #0000BB">$q</span><span style="color: #007700">, </span><span style="color: #DD0000">'flag2'</span><span style="color: #007700">=></span><span style="color: #0000BB">$p</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">$w </span><span style="color: #007700">= new </span><span style="color: #0000BB">FlagSet</span><span style="color: #007700">(array(</span><span style="color: #DD0000">'flag1'</span><span style="color: #007700">=></span><span style="color: #0000BB">$q</span><span style="color: #007700">));<br /><br />echo </span><span style="color: #DD0000">"\nComposite objects u(o,p) and v(q,p)\n"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">compareObjects</span><span style="color: #007700">(</span><span style="color: #0000BB">$u</span><span style="color: #007700">, </span><span style="color: #0000BB">$v</span><span style="color: #007700">);<br /><br />echo </span><span style="color: #DD0000">"\nu(o,p) and w(q)\n"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">compareObjects</span><span style="color: #007700">(</span><span style="color: #0000BB">$u</span><span style="color: #007700">, </span><span style="color: #0000BB">$w</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?></span> </span> </code></div> </div> <div class="example-contents"><p>The above example will output:</p></div> <div class="example-contents screen"> <div class="cdata"><pre> Composite objects u(o,p) and v(q,p) o1 == o2 : TRUE o1 != o2 : FALSE o1 === o2 : TRUE o1 !== o2 : FALSE u(o,p) and w(q) o1 == o2 : FALSE o1 != o2 : TRUE o1 === o2 : FALSE o1 !== o2 : TRUE </pre></div> </div> </div> </p> </div><hr /><div class="manualnavbar" style="text-align: center;"> <div class="prev" style="text-align: left; float: left;"><a href="oop4.newref.html">References inside the constructor</a></div> <div class="next" style="text-align: right; float: right;"><a href="debugger.html">Debugging in PHP</a></div> <div class="up"><a href="oop4.html">Classes and Objects (PHP 4)</a></div> <div class="home"><a href="index.html">PHP Manual</a></div> </div></body></html>