<!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>Computes the difference of arrays with additional index check, compares data and indexes by a callback function</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.array-udiff-assoc.html">array_udiff_assoc</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.array-udiff.html">array_udiff</a></div>
<div class="up"><a href="ref.array.html">Array Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.array-udiff-uassoc" class="refentry">
<div class="refnamediv">
<h1 class="refname">array_udiff_uassoc</h1>
<p class="verinfo">(PHP 5)</p><p class="refpurpose"><span class="refname">array_udiff_uassoc</span> — <span class="dc-title">Computes the difference of arrays with additional index check, compares data and indexes by a callback function</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.array-udiff-uassoc-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="type">array</span> <span class="methodname"><strong>array_udiff_uassoc</strong></span>
( <span class="methodparam"><span class="type">array</span> <code class="parameter">$array1</code></span>
, <span class="methodparam"><span class="type">array</span> <code class="parameter">$array2</code></span>
[, <span class="methodparam"><span class="type">array</span> <code class="parameter">$...</code></span>
], <span class="methodparam"><span class="type"><a href="language.types.callable.html" class="type callable">callable</a></span> <code class="parameter">$value_compare_func</code></span>
, <span class="methodparam"><span class="type"><a href="language.types.callable.html" class="type callable">callable</a></span> <code class="parameter">$key_compare_func</code></span>
)</div>
<p class="para rdfs-comment">
Computes the difference of arrays with additional index check, compares
data and indexes by a callback function.
</p>
<p class="para">
Note that the keys are used in the comparison unlike
<span class="function"><a href="function.array-diff.html" class="function">array_diff()</a></span> and <span class="function"><a href="function.array-udiff.html" class="function">array_udiff()</a></span>.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.array-udiff-uassoc-parameters">
<h3 class="title">Parameters</h3>
<p class="para">
<dl>
<dt>
<span class="term"><em><code class="parameter">array1</code></em></span>
<dd>
<p class="para">
The first array.
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">array2</code></em></span>
<dd>
<p class="para">
The second array.
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">value_compare_func</code></em></span>
<dd>
<p class="para">
The comparison function must return an integer less than, equal to, or greater than zero if the first argument is considered to be respectively less than, equal to, or greater than the second.
</p>
<div class="methodsynopsis dc-description"><span class="type">int</span> <span class="methodname"><span class="replaceable">callback</span></span> ( <span class="methodparam"><span class="type"><a href="language.pseudo-types.html#language.types.mixed" class="type mixed">mixed</a></span> <code class="parameter">$a</code></span>, <span class="methodparam"><span class="type"><a href="language.pseudo-types.html#language.types.mixed" class="type mixed">mixed</a></span> <code class="parameter">$b</code></span> )</div>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">key_compare_func</code></em></span>
<dd>
<p class="para">
The comparison of keys (indices) is done also by the callback function
<em><code class="parameter">key_compare_func</code></em>. This behaviour is unlike what
<span class="function"><a href="function.array-udiff-assoc.html" class="function">array_udiff_assoc()</a></span> does, since the latter compares
the indices by using an internal function.
</p>
</dd>
</dt>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.array-udiff-uassoc-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
Returns an <span class="type"><a href="language.types.array.html" class="type array">array</a></span> containing all the values from
<em><code class="parameter">array1</code></em> that are not present in any of the other
arguments.
</p>
</div>
<div class="refsect1 examples" id="refsect1-function.array-udiff-uassoc-examples">
<h3 class="title">Examples</h3>
<p class="para">
<div class="example" id="example-4987">
<p><strong>Example #1 <span class="function"><strong>array_udiff_uassoc()</strong></span> example</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">cr </span><span style="color: #007700">{<br /> private </span><span style="color: #0000BB">$priv_member</span><span style="color: #007700">;<br /> function </span><span style="color: #0000BB">cr</span><span style="color: #007700">(</span><span style="color: #0000BB">$val</span><span style="color: #007700">)<br /> {<br /> </span><span style="color: #0000BB">$this</span><span style="color: #007700">-></span><span style="color: #0000BB">priv_member </span><span style="color: #007700">= </span><span style="color: #0000BB">$val</span><span style="color: #007700">;<br /> }<br /><br /> static function </span><span style="color: #0000BB">comp_func_cr</span><span style="color: #007700">(</span><span style="color: #0000BB">$a</span><span style="color: #007700">, </span><span style="color: #0000BB">$b</span><span style="color: #007700">)<br /> {<br /> if (</span><span style="color: #0000BB">$a</span><span style="color: #007700">-></span><span style="color: #0000BB">priv_member </span><span style="color: #007700">=== </span><span style="color: #0000BB">$b</span><span style="color: #007700">-></span><span style="color: #0000BB">priv_member</span><span style="color: #007700">) return </span><span style="color: #0000BB">0</span><span style="color: #007700">;<br /> return (</span><span style="color: #0000BB">$a</span><span style="color: #007700">-></span><span style="color: #0000BB">priv_member </span><span style="color: #007700">> </span><span style="color: #0000BB">$b</span><span style="color: #007700">-></span><span style="color: #0000BB">priv_member</span><span style="color: #007700">)? </span><span style="color: #0000BB">1</span><span style="color: #007700">:-</span><span style="color: #0000BB">1</span><span style="color: #007700">;<br /> }<br /><br /> static function </span><span style="color: #0000BB">comp_func_key</span><span style="color: #007700">(</span><span style="color: #0000BB">$a</span><span style="color: #007700">, </span><span style="color: #0000BB">$b</span><span style="color: #007700">)<br /> {<br /> if (</span><span style="color: #0000BB">$a </span><span style="color: #007700">=== </span><span style="color: #0000BB">$b</span><span style="color: #007700">) return </span><span style="color: #0000BB">0</span><span style="color: #007700">;<br /> return (</span><span style="color: #0000BB">$a </span><span style="color: #007700">> </span><span style="color: #0000BB">$b</span><span style="color: #007700">)? </span><span style="color: #0000BB">1</span><span style="color: #007700">:-</span><span style="color: #0000BB">1</span><span style="color: #007700">;<br /> }<br />}<br /></span><span style="color: #0000BB">$a </span><span style="color: #007700">= array(</span><span style="color: #DD0000">"0.1" </span><span style="color: #007700">=> new </span><span style="color: #0000BB">cr</span><span style="color: #007700">(</span><span style="color: #0000BB">9</span><span style="color: #007700">), </span><span style="color: #DD0000">"0.5" </span><span style="color: #007700">=> new </span><span style="color: #0000BB">cr</span><span style="color: #007700">(</span><span style="color: #0000BB">12</span><span style="color: #007700">), </span><span style="color: #0000BB">0 </span><span style="color: #007700">=> new </span><span style="color: #0000BB">cr</span><span style="color: #007700">(</span><span style="color: #0000BB">23</span><span style="color: #007700">), </span><span style="color: #0000BB">1</span><span style="color: #007700">=> new </span><span style="color: #0000BB">cr</span><span style="color: #007700">(</span><span style="color: #0000BB">4</span><span style="color: #007700">), </span><span style="color: #0000BB">2 </span><span style="color: #007700">=> new </span><span style="color: #0000BB">cr</span><span style="color: #007700">(-</span><span style="color: #0000BB">15</span><span style="color: #007700">),);<br /></span><span style="color: #0000BB">$b </span><span style="color: #007700">= array(</span><span style="color: #DD0000">"0.2" </span><span style="color: #007700">=> new </span><span style="color: #0000BB">cr</span><span style="color: #007700">(</span><span style="color: #0000BB">9</span><span style="color: #007700">), </span><span style="color: #DD0000">"0.5" </span><span style="color: #007700">=> new </span><span style="color: #0000BB">cr</span><span style="color: #007700">(</span><span style="color: #0000BB">22</span><span style="color: #007700">), </span><span style="color: #0000BB">0 </span><span style="color: #007700">=> new </span><span style="color: #0000BB">cr</span><span style="color: #007700">(</span><span style="color: #0000BB">3</span><span style="color: #007700">), </span><span style="color: #0000BB">1</span><span style="color: #007700">=> new </span><span style="color: #0000BB">cr</span><span style="color: #007700">(</span><span style="color: #0000BB">4</span><span style="color: #007700">), </span><span style="color: #0000BB">2 </span><span style="color: #007700">=> new </span><span style="color: #0000BB">cr</span><span style="color: #007700">(-</span><span style="color: #0000BB">15</span><span style="color: #007700">),);<br /><br /></span><span style="color: #0000BB">$result </span><span style="color: #007700">= </span><span style="color: #0000BB">array_udiff_uassoc</span><span style="color: #007700">(</span><span style="color: #0000BB">$a</span><span style="color: #007700">, </span><span style="color: #0000BB">$b</span><span style="color: #007700">, array(</span><span style="color: #DD0000">"cr"</span><span style="color: #007700">, </span><span style="color: #DD0000">"comp_func_cr"</span><span style="color: #007700">), array(</span><span style="color: #DD0000">"cr"</span><span style="color: #007700">, </span><span style="color: #DD0000">"comp_func_key"</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">$result</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>
Array
(
[0.1] => cr Object
(
[priv_member:private] => 9
)
[0.5] => cr Object
(
[priv_member:private] => 12
)
[0] => cr Object
(
[priv_member:private] => 23
)
)
</pre></div>
</div>
</div>
</p>
<p class="simpara">
In our example above you see the <em>"1" => new cr(4)</em>
pair is present in both arrays and thus it is not in the output from the
function. Keep in mind that you have to supply 2 callback functions.
</p>
</div>
<div class="refsect1 notes" id="refsect1-function.array-udiff-uassoc-notes">
<h3 class="title">Notes</h3>
<blockquote class="note"><p><strong class="note">Note</strong>:
<span class="simpara">
Please note that this function only checks one dimension of a n-dimensional
array. Of course you can check deeper dimensions by using, for example,
<em>array_udiff_uassoc($array1[0], $array2[0], "data_compare_func",
"key_compare_func");</em>.
</span>
</p></blockquote>
</div>
<div class="refsect1 seealso" id="refsect1-function.array-udiff-uassoc-seealso">
<h3 class="title">See Also</h3>
<p class="para">
<ul class="simplelist">
<li class="member"> <span class="function"><a href="function.array-diff.html" class="function" rel="rdfs-seeAlso">array_diff()</a> - Computes the difference of arrays</span></li>
<li class="member"> <span class="function"><a href="function.array-diff-assoc.html" class="function" rel="rdfs-seeAlso">array_diff_assoc()</a> - Computes the difference of arrays with additional index check</span></li>
<li class="member"> <span class="function"><a href="function.array-udiff.html" class="function" rel="rdfs-seeAlso">array_udiff()</a> - Computes the difference of arrays by using a callback function for data comparison</span></li>
<li class="member"> <span class="function"><a href="function.array-udiff-assoc.html" class="function" rel="rdfs-seeAlso">array_udiff_assoc()</a> - Computes the difference of arrays with additional index check, compares data by a callback function</span></li>
<li class="member"> <span class="function"><a href="function.array-intersect.html" class="function" rel="rdfs-seeAlso">array_intersect()</a> - Computes the intersection of arrays</span></li>
<li class="member"> <span class="function"><a href="function.array-intersect-assoc.html" class="function" rel="rdfs-seeAlso">array_intersect_assoc()</a> - Computes the intersection of arrays with additional index check</span></li>
<li class="member"> <span class="function"><a href="function.array-uintersect.html" class="function" rel="rdfs-seeAlso">array_uintersect()</a> - Computes the intersection of arrays, compares data by a callback function</span></li>
<li class="member"> <span class="function"><a href="function.array-uintersect-assoc.html" class="function" rel="rdfs-seeAlso">array_uintersect_assoc()</a> - Computes the intersection of arrays with additional index check, compares data by a callback function</span></li>
<li class="member"> <span class="function"><a href="function.array-uintersect-uassoc.html" class="function" rel="rdfs-seeAlso">array_uintersect_uassoc()</a> - Computes the intersection of arrays with additional index check, compares data and indexes by a callback functions</span></li>
</ul>
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.array-udiff-assoc.html">array_udiff_assoc</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.array-udiff.html">array_udiff</a></div>
<div class="up"><a href="ref.array.html">Array Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
