عرض مصدر PHP/array diff key

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

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

== الوصف ==
<syntaxhighlight lang="php">
array array_diff_key ( array $array1 , array $array2 [, array $... ] )
</syntaxhighlight>تقارن الدالة مفاتيح المصفوفات المُمَرََرة كمعاملات وتعيد الفرق بينها. هذه الدالة تشبه دالة <code>[[PHP/Function/array-diff|array_diff()‎]]</code> إلا أنها تقارن باستخدام المفاتيح وليس القيم.

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

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

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

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

== القيم المعادة ==
تعيد الدالة مصفوفةً جديدةً من القيم الموجودة بالمصفوفة الأولى التي تكون مفاتيحها غير موجودة بأي من المصفوفات الأخرى.

== أمثلة ==
المثال 1: مثال بسيط عن الدالة <code>array_diff_key()‎</code>

يعدّ زوجان من المفاتيح والقيم متماثلان فقط إذا كان <code>‎(string) $key1 === (string) $key2</code>. بكلمات أخرى، تستخدم الدالة المقارنة الصارمة لمقارنة القيم ولذلك يجب أن يكون التمثيل النصي للقيم متماثلًا تمامًا.<syntaxhighlight lang="php">
<?php
$array1 = array('blue' => 1, 'red' => 2, 'green' => 3, 'purple' => 4);
$array2 = array('green' => 5, 'yellow' => 7, 'cyan' => 8);

var_dump(array_diff_key($array1, $array2));
?>

</syntaxhighlight>

نتيجة المثال السابق:<syntaxhighlight lang="text">
array(3) {
  ["blue"]=>
  int(1)
  ["red"]=>
  int(2)
  ["purple"]=>
  int(4)
}
</syntaxhighlight>

المثال 2: مثال بسيط آخر عن الدالة <code>array_diff_key()‎</code><syntaxhighlight lang="php">

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

var_dump(array_diff_key($array1, $array2, $array3));
?>

</syntaxhighlight>

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


array(2) {
  ["red"]=>
  int(2)
  ["purple"]=>
  int(4)
}


</syntaxhighlight>

== ملاحظات ==
تتحقق هذه الدالة من بعد واحد فقط للمصفوفات متعددة الأبعاد. بالطبع يمكنك التحقق من أبعاد أعمق باستخدام <code>array_diff_key($array1[0], $array2[0])‎</code> على سبيل المثال.

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

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