الفرق بين المراجعتين لصفحة: «PHP/array key exists»
< PHP
ط إضافة عنوان الصفحة والتصنيفات |
لا ملخص تعديل |
||
| سطر 2: | سطر 2: | ||
(PHP 4 >= 4.07, PHP 5, PHP 7) | (PHP 4 >= 4.07, PHP 5, PHP 7) | ||
تتحقق الدالة array_key_exists() من وجود المفتاح أو الفهرس داخل المصفوفة. | تتحقق الدالة <code>array_key_exists()</code> من وجود المفتاح أو الفهرس داخل المصفوفة. | ||
== الوصف == | == الوصف == | ||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
bool array_key_exists ( mixed $key , array $array ) | bool array_key_exists ( mixed $key , array $array ) | ||
</syntaxhighlight>تعيد الدالة القيمة true إذا كان المفتاح key موجودًا بالمصفوفة. يمكن أن يأخذ المتغير key أي قيمة مسموح بها كفهرس للمصفوفة. | </syntaxhighlight>تعيد الدالة القيمة <code>true</code> إذا كان المفتاح <code>key</code> موجودًا بالمصفوفة. يمكن أن يأخذ المتغير <code>key</code> أي قيمة مسموح بها كفهرس للمصفوفة. | ||
== المعاملات == | == المعاملات == | ||
=== <code>key</code> === | |||
المفتاح الذي ستتحقق الدالة من وجوده بالمصفوفة. | المفتاح الذي ستتحقق الدالة من وجوده بالمصفوفة. | ||
array | === <code>array</code> === | ||
مصفوفة تحتوي على المفاتيح التي ستبحث الدالة فيها. | مصفوفة تحتوي على المفاتيح التي ستبحث الدالة فيها. | ||
== القيم المعادة == | == القيم المعادة == | ||
تعيد القيمة true في حالة النجاح والقيمة false في حالة الفشل. | تعيد القيمة <code>true</code> في حالة النجاح والقيمة <code>false</code> في حالة الفشل. | ||
لاحظ أن الدالة ستبحث عن المفاتيح داخل البعد الأول فقط. لن تعثر الدالة على المفاتيح المتداخلة في المصفوفات متعددة الأبعاد. | لاحظ أن الدالة ستبحث عن المفاتيح داخل البعد الأول فقط. لن تعثر الدالة على المفاتيح المتداخلة في المصفوفات متعددة الأبعاد. | ||
== أمثلة == | == أمثلة == | ||
المثال 1: مثال بسيط عن الدالة array_key_exists()<syntaxhighlight lang="php"> | المثال 1: مثال بسيط عن الدالة <code>array_key_exists()</code><syntaxhighlight lang="php"> | ||
<?php | <?php | ||
$search_array = array('first' => 1, 'second' => 4); | $search_array = array('first' => 1, 'second' => 4); | ||
if (array_key_exists('first', $search_array)) { | if (array_key_exists('first', $search_array)) { | ||
echo "The 'first' element is in the array"; | |||
} | } | ||
?> | |||
</syntaxhighlight> | </syntaxhighlight> | ||
المثال 2: مقارنة الدالة array_key_exists() بالدالة isset()<syntaxhighlight lang="php"> | المثال 2: مقارنة الدالة <code>array_key_exists()</code> بالدالة <code>[[PHP/Function/isset|isset()]]</code><syntaxhighlight lang="php"> | ||
<?php | <?php | ||
$search_array = array('first' => null, 'second' => 4); | $search_array = array('first' => null, 'second' => 4); | ||
// | // false | ||
isset($search_array['first']); | isset($search_array['first']); | ||
// | // true | ||
array_key_exists('first', $search_array); | array_key_exists('first', $search_array); | ||
?> | |||
</syntaxhighlight> | </syntaxhighlight> | ||
== ملاحظات == | == ملاحظات == | ||
تعيد الدالة القيمة true إذا كان المفتاح هو خاصيةٌ (property) في الكائن (object) المُمَرر إلى الدالة كمصفوفة وذلك لدعم الإصدارات السابقة. لا يجب الاعتماد على هذا السلوك ويجب التحقق من أن المعامل array هو من النوع array. | تعيد الدالة القيمة <code>true</code> إذا كان المفتاح هو خاصيةٌ (property) في [[PHP/Types/object|الكائن]] (object) المُمَرر إلى الدالة كمصفوفة وذلك لدعم الإصدارات السابقة. لا يجب الاعتماد على هذا السلوك ويجب التحقق من أن المعامل <code>array</code> هو من النوع [[PHP/Types/array|array]]. | ||
استخدم الدالة property_exists() للتحقق من وجود صفة داخل أحد الكائنات. | استخدم الدالة <code>[[PHP/Function/property-exists|property_exists()]]</code> للتحقق من وجود صفة داخل أحد الكائنات. | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة isset(): تحدد ما إذا كان المتغير موجودٌ وأن قيمته لا تساوي NULL. | * الدالة <code>[[PHP/Function/isset|isset()]]</code>: تحدد ما إذا كان المتغير موجودٌ وأن قيمته لا تساوي <code>NULL</code>. | ||
* الدالة array_keys(): تعيد كل أو قسم من مفاتيح المصفوفة. | * الدالة <code>[[PHP/Function/array-keys|array_keys()]]</code>: تعيد كل أو قسم من مفاتيح المصفوفة. | ||
* الدالة in_array(): تتحقق من وجود إحدى القيم داخل المصفوفة. | * الدالة <code>[[PHP/Function/in-array|in_array()]]</code>: تتحقق من وجود إحدى القيم داخل المصفوفة. | ||
* الدالة property_exists(): تتحقق من وجود إحدى الخاصيات داخل الكائن. | * الدالة <code>[[PHP/Function/property-exists|property_exists()]]</code>: تتحقق من وجود إحدى الخاصيات داخل الكائن. | ||
== مصادر == | == مصادر == | ||
مراجعة 06:31، 14 مارس 2018
(PHP 4 >= 4.07, PHP 5, PHP 7)
تتحقق الدالة array_key_exists() من وجود المفتاح أو الفهرس داخل المصفوفة.
الوصف
bool array_key_exists ( mixed $key , array $array )
تعيد الدالة القيمة true إذا كان المفتاح key موجودًا بالمصفوفة. يمكن أن يأخذ المتغير key أي قيمة مسموح بها كفهرس للمصفوفة.
المعاملات
key
المفتاح الذي ستتحقق الدالة من وجوده بالمصفوفة.
array
مصفوفة تحتوي على المفاتيح التي ستبحث الدالة فيها.
القيم المعادة
تعيد القيمة true في حالة النجاح والقيمة false في حالة الفشل.
لاحظ أن الدالة ستبحث عن المفاتيح داخل البعد الأول فقط. لن تعثر الدالة على المفاتيح المتداخلة في المصفوفات متعددة الأبعاد.
أمثلة
المثال 1: مثال بسيط عن الدالة array_key_exists()
<?php
$search_array = array('first' => 1, 'second' => 4);
if (array_key_exists('first', $search_array)) {
echo "The 'first' element is in the array";
}
?>
المثال 2: مقارنة الدالة array_key_exists() بالدالة isset()
<?php
$search_array = array('first' => null, 'second' => 4);
// false
isset($search_array['first']);
// true
array_key_exists('first', $search_array);
?>
ملاحظات
تعيد الدالة القيمة true إذا كان المفتاح هو خاصيةٌ (property) في الكائن (object) المُمَرر إلى الدالة كمصفوفة وذلك لدعم الإصدارات السابقة. لا يجب الاعتماد على هذا السلوك ويجب التحقق من أن المعامل array هو من النوع array.
استخدم الدالة property_exists() للتحقق من وجود صفة داخل أحد الكائنات.
انظر أيضًا
- الدالة
isset(): تحدد ما إذا كان المتغير موجودٌ وأن قيمته لا تساويNULL. - الدالة
array_keys(): تعيد كل أو قسم من مفاتيح المصفوفة. - الدالة
in_array(): تتحقق من وجود إحدى القيم داخل المصفوفة. - الدالة
property_exists(): تتحقق من وجود إحدى الخاصيات داخل الكائن.