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

<noinclude>{{DISPLAYTITLE:<code>array_key_exists()‎</code>}}</noinclude>
(PHP 4 >= 4.07, PHP 5, PHP 7)

تتحقق الدالة <code>array_key_exists()‎</code> من وجود المفتاح أو الفهرس داخل المصفوفة.

== الوصف ==
<syntaxhighlight lang="php">
bool array_key_exists ( mixed $key , array $array )
</syntaxhighlight>تعيد الدالة القيمة <code>true</code> إذا كان المفتاح <code>key</code> موجودًا بالمصفوفة. يمكن أن يأخذ المتغير <code>key</code> أي قيمة مسموح بها كفهرس للمصفوفة.

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

=== <code>key</code> ===
المفتاح الذي ستتحقق الدالة من وجوده بالمصفوفة.

=== <code>array</code> ===
مصفوفة تحتوي على المفاتيح التي ستبحث الدالة فيها.

== القيم المعادة ==
تعيد القيمة <code>true</code> في حالة النجاح والقيمة <code>false</code> في حالة الفشل.

لاحظ أن الدالة ستبحث عن المفاتيح داخل البعد الأول فقط. لن تعثر الدالة على المفاتيح المتداخلة في المصفوفات متعددة الأبعاد.

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

<?php
$search_array = array('first' => 1, 'second' => 4);
if (array_key_exists('first', $search_array)) {
    echo "The 'first' element is in the array";
}
?>

</syntaxhighlight>

المثال 2: مقارنة الدالة <code>array_key_exists()‎</code> بالدالة <code>[[PHP/isset|isset()‎]]</code><syntaxhighlight lang="php">

<?php
$search_array = array('first' => null, 'second' => 4);

// false
isset($search_array['first']);

// true
array_key_exists('first', $search_array);
?>

</syntaxhighlight>

== ملاحظات ==
تعيد الدالة القيمة <code>true</code> إذا كان المفتاح هو خاصيةٌ (property) في [[PHP/Types/object|الكائن]] (object) المُمَرر إلى الدالة كمصفوفة وذلك لدعم الإصدارات السابقة. لا يجب الاعتماد على هذا السلوك ويجب التحقق من أن المعامل <code>array</code> هو من النوع [[PHP/array|array]].

استخدم الدالة <code>[[PHP/Function/property-exists|property_exists()‎]]</code> للتحقق من وجود صفة داخل أحد الكائنات.

== انظر أيضًا ==
* الدالة <code>[[PHP/isset|isset()]]‎</code>: تحدد ما إذا كان المتغير موجودٌ وأن قيمته لا تساوي <code>NULL</code>.
* الدالة <code>[[PHP/array-keys|array_keys()‎]]</code>: تعيد كل أو قسم من مفاتيح المصفوفة.
* الدالة <code>[[PHP/in array|in_array()]]‎</code>: تتحقق من وجود إحدى القيم داخل المصفوفة.
* الدالة <code>[[PHP/Function/property-exists|property_exists()‎]]</code>: تتحقق من وجود إحدى الخاصيات داخل الكائن.

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