عرض مصدر PHP/array intersect ukey

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

تحسب الدالة <code>array_intersect_ukey()‎</code> التقاطع (intersection) بين المصفوفات باستخدام دالة يحددها المستخدم لمقارنة المفاتيح.

== الوصف ==
<syntaxhighlight lang="php">
array array_intersect_ukey ( array $array1 , array $array2 [, array $... ], callable $key_compare_func )
</syntaxhighlight>تعيد الدالة كل عناصر المصفوفة <code>array1</code> التي تحتوي على مفاتيح تطابقها الدالة <code>key_compare_func</code> بكل مفاتيح المصفوفات الأخرى.

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

=== <code>array1</code> ===
مصفوفة العناصر التي ستتحقق الدالة منها.

=== <code>array2</code> ===
مصفوفة العناصر التي ستقارن بها الدالة.

=== <code>…</code> ===
مجموعة متغيرة من المصفوفات التي ستقارن الدالة بها.

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

== القيم المعادة ==
تعيد مصفوفة تحتوي على كل عناصر المصفوفة <code>array1</code> الموجودة مفاتيحها بكل المصفوفات الأخرى.

== أمثلة ==
المثال 1: مثال بسيط عن الدالة <code>array_intersect_ukey()</code>‎<syntaxhighlight lang="php">

<?php
function key_compare_func($key1, $key2)
{
    if ($key1 == $key2)
        return 0;
    else if ($key1 > $key2)
        return 1;
    else
        return -1;
}

$array1 = array('blue'  => 1, 'red'  => 2, 'green'  => 3, 'purple' => 4);
$array2 = array('green' => 5, 'blue' => 6, 'yellow' => 7, 'cyan'   => 8);

var_dump(array_intersect_ukey($array1, $array2, 'key_compare_func'));
?>

</syntaxhighlight>

نتيجة المثال السابق:<syntaxhighlight lang="php">


array(2) {
  ["blue"]=>
  int(1)
  ["green"]=>
  int(3)
}


</syntaxhighlight>

في هذا المثال، سترى أن فقط المفاتيح <code>"blue"</code> و <code>"green"</code> موجودة في كلتي المصفوفتين ولذلك أعادتهما الدالة. لاحظ أيضاً أن القيم المرتبطة مع المفاتيح <code>"blue"</code> و <code>"green"</code> مختلفة بين المصفوفتين. ما يزال هناك تطابق مع ذلك لأن الدالة تقارن باستخدام المفاتيح فقط. وتكون القيم المعادة هي تلك الموجودة بالمصفوفة <code>array1</code>.

== انظر أيضًا ==
* الدالة <code>[[PHP/array-diff|array_diff()]]</code>‎: تحسب الفرق بين المصفوفات.
* الدالة <code>[[PHP/array-udiff|array_udiff()‎]]</code>: تحسب الفرق بين المصفوفات باستخدام دالة يحددها المستخدم للمقارنة بين البيانات.
* الدالة <code>[[PHP/array-diff-assoc|array_diff_assoc()‎]]</code>: تحسب الفرق بين المصفوفات مع استخدام تحقق إضافي من الفهارس.
* الدالة <code>[[PHP/array-diff-uassoc|array_diff_uassoc()‎]]</code>: تحسب الفرق بين المصفوفات مع استخدام تحقق إضافي من الفهارس عن طريق تنفيذ دالة يحددها المستخدم.
* الدالة <code>[[PHP/array-udiff-assoc|array_udiff_assoc()‎]]</code>: تحسب الفرق بين المصفوفات مع استخدام تحقق إضافي من الفهارس وتقارن البيانات باستخدام دالة يحددها المستخدم.
* الدالة <code>[[PHP/array-udiff-uassoc|array_udiff_uassoc()‎]]</code>: تحسب الفرق بين المصفوفات مع استخدام تحقق إضافي من الفهارس وتقارن البيانات والفهارس باستخدام دالة يحددها المستخدم.
* الدالة <code>[[PHP/array-diff-key|array_diff_key()‎]]</code>: تحسب الفرق بين المصفوفات باستخدام المفاتيح للمقارنة.
* الدالة <code>[[PHP/array-diff-ukey|array_diff_ukey()‎]]</code>: تحسب الفرق بين المصفوفات باستخدام دالة يحددها المستخدم لمقارنة المفاتيح.
* الدالة <code>[[PHP/array-intersect|array_intersect()]]</code>‎: تحسب التقاطع بين المصفوفات.
* الدالة <code>[[PHP/array-intersect-assoc|array_intersect_assoc()‎]]</code>: تحسب التقاطع بين المصفوفات مع استخدام تحقق إضافي للفهارس.
* الدالة <code>[[PHP/array-intersect-uassoc|array_intersect_uassoc()‎]]</code>: تحسب التقاطع بين المصفوفات مع استخدام تحقق إضافي من الفهارس، كما أنها تقارن الفهارس باستخدام دالة يحددها المستخدم.
* الدالة <code>[[PHP/array-intersect-key|array_intersect_key()‎]]</code>: تحسب التقاطع بين المصفوفات باستخدام المفاتيح للمقارنة.

== مصادر ==
* [http://php.net/manual/en/function.array-intersect-ukey.php صفحة الدالة array_intersect_ukey في توثيق PHP الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Array]]