عرض مصدر PHP/array udiff assoc

<noinclude>{{DISPLAYTITLE:<code>array_udiff_assoc()‎</code>}}</noinclude>
(PHP 5, PHP 7)

تحسب الدالة <code>array_udiff_assoc()</code>‎ الفرق بين المصفوفات مع استخدام تحقق إضافي بمقارنة الفهارس، وتقارن البيانات باستخدام دالة <code>[[PHP/callable|callback]]</code> مُعرَّفة من المستخدم .

== الوصف ==
<syntaxhighlight lang="php">
array array_udiff_assoc ( array $array1 , array $array2 [, array $... ], callable$value_compare_func )
</syntaxhighlight>تحسب الدالة <code>array_udiff_assoc()‎</code> الفرق بين المصفوفات مع استخدام تحقق إضافي بمقارنة الفهارس، وتقارن البيانات باستخدام دالة مُعرَّفة من المستخدم <code>[[PHP/callable|callback]]</code>.

== المعاملات ==

=== <code>array1</code> ===
المصفوفة الأولى.

=== <code>array2</code> ===
المصفوفة الثانية.

=== <code>value_compare_func</code> ===
يجب أن تُعيد دالة المقارنة عددًا صحيحًا أقل من أو يساوي أو أكبر من الصفر إذا كان الوسيط الأول يعتبر أقل من أو يساوي أو أكبر من الوسيط الثاني على التوالي. لاحظ أنه قبل PHP 7.0.0 كان يجب أن يكون هذا العدد الصحيح في النطاق من ‎-2147483648 إلى 2147483647.<syntaxhighlight lang="php">
int callback ( mixed $a, mixed $b )
</syntaxhighlight>

== القيم المعادة ==
تعيد الدالة <code>array_udiff_assoc()</code>‎ مصفوفةً تحتوي على كافة القيم من <code>array1</code> والتي تكون غير موجودة في أي من الوسائط الأخرى. لاحظ أن المفاتيح تُستخدم في المقارنة على عكس <code>[[PHP/array_diff|array_diff()]]</code>‎ و <code>[[PHP/array_udiff|array_udiff()]]</code>‎. وتُقارن بيانات المصفوفات بواسطة دالة مُعّرفة من المستخدم (<code>[[PHP/callable|callback]]</code>). في هذا الجانب، يكون السلوك معاكسًا لسلوك الدالة <code>[[PHP/array_diff_assoc|array_diff_assoc()]]</code>‎ التي تستخدم دالةً داخليةً للمقارنة.

== أمثلة ==
المثال 1: مثال على الدالة <code>array_udiff_assoc()</code>‎<syntaxhighlight lang="php">
<?php
class cr {
    private $priv_member;
    function cr($val)
    {
        $this->priv_member = $val;
    }

    static function comp_func_cr($a, $b)
    {
        if ($a->priv_member === $b->priv_member) return 0;
        return ($a->priv_member > $b->priv_member)? 1:-1;
    }
}

$a = array("0.1" => new cr(9), "0.5" => new cr(12), 0 => new cr(23), 1=> new cr(4), 2 => new cr(-15),);
$b = array("0.2" => new cr(9), "0.5" => new cr(22), 0 => new cr(3), 1=> new cr(4), 2 => new cr(-15),);

$result = array_udiff_assoc($a, $b, array("cr", "comp_func_cr"));
print_r($result);
?>
</syntaxhighlight>سوف تكون مُخرجات المثال أعلاه كالتالي:<syntaxhighlight lang="php">
Array
(
    [0.1] => cr Object
        (
            [priv_member:private] => 9
        )

    [0.5] => cr Object
        (
            [priv_member:private] => 12
        )

    [0] => cr Object
        (
            [priv_member:private] => 23
        )
)
</syntaxhighlight>في المثال أعلاه، سترى الزوج ‎‎‎<code>"1" => ‎new cr(4)</code>‎ موجود في كلتا المصفوفتين، وبالتالي فهو غير موجود في مخرجات الدالة.

== ملاحظات ==
ملاحظة : يرجى ملاحظة أن هذه الدالة تفحص بُعدًا واحدًا فقط من مصفوفة متعددة الأبعاد (n-dimensional). ويمكننا بالطبع فحص أبعاد أعمق باستخدام الدالة التالية على سبيل المثال،<syntaxhighlight lang="php">
array_udiff_assoc($array1[0], $array2[0], "some_comparison_func");
</syntaxhighlight>

== انظر أيضًا ==
* الدالة <code>[[PHP/array_diff|array_diff()]]</code>‎: حساب الفرق بين المصفوفات.
* الدالة <code>[[PHP/array_diff_assoc|array_diff_assoc()]]</code>‎: حساب الفرق بين المصفوفات مع استخدام تحقق إضافي بمقارنة الفهارس.
* الدالة <code>[[PHP/array_diff_uassoc|array_diff_uassoc()]]</code>‎: حساب الفرق بين المصفوفات مع استخدام تحقق إضافي بمقارنة الفهارس يُنفّذ بواسطة دالة مُعرّفة من المستخدم.
* الدالة <code>[[PHP/array_udiff|array_udiff()]]</code>‎: حساب الفرق بين المصفوفات باستخدام دالة مُعرّفة من المستخدم للمقارنة بين البيانات.
* الدالة <code>[[PHP/array_udiff_uassoc|array_udiff_uassoc()]]</code>‎: حساب الفرق بين المصفوفات مع استخدام تحقق إضافي بمقارنة الفهارس، ومقارنة البيانات والفهارس بواسطة دالة مُعرّفة من المستخدم.
* الدالة <code>[[PHP/array_intersect|array_intersect()]]</code>‎: حساب تقاطع المصفوفات.
* الدالة <code>[[PHP/array_intersect_assoc|array_intersect_assoc()]]</code>‎: حساب تقاطع المصفوفات مع استخدام تحقق إضافي بمقارنة الفهارس.
* الدالة <code>[[PHP/array_uintersect|array_uintersect()]]</code>‎: حساب تقاطع المصفوفات، ومقارنة البيانات بواسطة دالة مُعرّفة من المستخدم.
* الدالة <code>[[PHP/array_uintersect_assoc|array_uintersect_assoc()]]</code>‎: حساب تقاطع المصفوفات مع استخدام تحقق إضافي بمقارنة الفهارس، ومقارنة البيانات بواسطة دالة مُعرّفة من المستخدم.
* الدالة <code>[[PHP/array_uintersect_uassoc|array_uintersect_uassoc()]]</code>‎: حساب تقاطع المصفوفات مع استخدام تحقق إضافي بمقارنة الفهارس، ومقارنة البيانات والفهارس بواسطة دوال منفصلة مُعرّفة من المستخدم.

== مصادر ==
* [http://php.net/manual/en/function.array-udiff-assoc.php صفحة الدالة array_udiff_assoc في توثيق PHP الرسمي].

[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Array]]