الفرق بين المراجعتين ل"PHP/array search"
ط (نقل عبد اللطيف ايمش صفحة PHP/Function/array-search إلى PHP/array search: إعادة هيكلة التوثيق) |
|||
(8 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
سطر 12: | سطر 12: | ||
=== <code>needle</code> === | === <code>needle</code> === | ||
− | القيمة التي نبحث عنها. | + | القيمة التي نبحث عنها. |
+ | |||
+ | ملاحظة:إذا كانت <code>needle</code> سلسلةً نصيةً (string)، فستكون المقارنة بطريقة حساسة لحالة الأحرف. | ||
=== <code>haystack</code> === | === <code>haystack</code> === | ||
سطر 23: | سطر 25: | ||
تعيد هذه الدالة مفتاح العنصر الي يحمل القيمة <code>needle</code> إذا عُثِرَ عليه في المصفوفة، أو تعيد <code>FALSE</code> خلاف ذلك. | تعيد هذه الدالة مفتاح العنصر الي يحمل القيمة <code>needle</code> إذا عُثِرَ عليه في المصفوفة، أو تعيد <code>FALSE</code> خلاف ذلك. | ||
− | إذا عُثِرَ على <code>needle</code> في <code>haystack</code> أكثر من مرة، فسيُعاد مفتاح أول عنصر مطابق. وتُستخدم الدالة <code>[[PHP/ | + | إذا عُثِرَ على <code>needle</code> في <code>haystack</code> أكثر من مرة، فسيُعاد مفتاح أول عنصر مطابق. وتُستخدم الدالة <code>[[PHP/array_keys|array_keys()]]</code> بدلاً من ذلك مع المعامل <code>search_value</code> الاختياري لإسترجاع المفاتيح لجميع القيم المطابقة. |
+ | |||
+ | تحذير: قد تُعيد هذه الدالة القيمة المنطقية <code>FALSE</code>، ولكن قد تُعيد أيضًا قيمة غير منطقية تُقيّم بنفس القيمة <code>FALSE</code>. يرجى قراءة قسم القيم المنطقية [[PHP/boolean|Booleans]] لمزيد من المعلومات. يستخدم [[PHP/comparison operators|العامل ===]] لاختبار القيمة المعادة من هذه الدالة. | ||
== سجل التغييرات == | == سجل التغييرات == | ||
سطر 45: | سطر 49: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
− | * الدالة <code>[[PHP/ | + | * الدالة <code>[[PHP/array_keys|array_keys()]]</code>: إعادة كافة مفاتيح أو مجموعة فرعية من مفاتيح المصفوفة. |
− | * الدالة <code>[[PHP/ | + | * الدالة <code>[[PHP/array_values|array_values()]]</code>: إعادة كافة قيم عناصر المصفوفة. |
− | * الدالة <code>[[PHP/ | + | * الدالة <code>[[PHP/array_key_exists|array_key_exists()]]</code>: التحقق من وجود مفتاح أو مؤشر معين في المصفوفة. |
− | * الدالة <code>[[PHP | + | * الدالة <code>[[PHP/in array|in_array()]]</code>: التحقق من وجود قيمة ما في مصفوفة. |
== مصادر == | == مصادر == |
المراجعة الحالية بتاريخ 03:49، 4 أبريل 2018
(PHP 4 >= 4.0.5, PHP 5, PHP 7)
تبحث الدالة array_search()
في المصفوفة عن قيمة محددة وتعيد مفتاح أول عنصر يحمل هذه القيمة إذا نجح.
الوصف
mixed array_search ( mixed $needle , array $haystack [, bool $strict = FALSE ] )
تبحث الدالة array_search()
في المصفوفة haystack
عن القيمة needle
.
المعاملات
needle
القيمة التي نبحث عنها.
ملاحظة:إذا كانت needle
سلسلةً نصيةً (string)، فستكون المقارنة بطريقة حساسة لحالة الأحرف.
haystack
المصفوفة المراد البحث فيها.
strict
إذا ضُبِطَ المعامل الثالث strict
إلى القيمة TRUE
فستبحث الدالة array_search()
عن عناصر متطابقة في المصفوفة haystack
. الأمر الذي يعني أنه سيؤدي أيضًا إلى إجراء مقارنة صارمة للنوع للقيمة needle
في المصفوفة haystack
، ويجب أن تكون الكائنات متماثلة.
القيم المعادة
تعيد هذه الدالة مفتاح العنصر الي يحمل القيمة needle
إذا عُثِرَ عليه في المصفوفة، أو تعيد FALSE
خلاف ذلك.
إذا عُثِرَ على needle
في haystack
أكثر من مرة، فسيُعاد مفتاح أول عنصر مطابق. وتُستخدم الدالة array_keys()
بدلاً من ذلك مع المعامل search_value
الاختياري لإسترجاع المفاتيح لجميع القيم المطابقة.
تحذير: قد تُعيد هذه الدالة القيمة المنطقية FALSE
، ولكن قد تُعيد أيضًا قيمة غير منطقية تُقيّم بنفس القيمة FALSE
. يرجى قراءة قسم القيم المنطقية Booleans لمزيد من المعلومات. يستخدم العامل === لاختبار القيمة المعادة من هذه الدالة.
سجل التغييرات
الإصدار | الوصف |
---|---|
5.3.0 | كما هو الحال مع جميع دوال PHP الداخلية اعتبارًا من الإصدار 5.3.0، تعيد الدالة array_search() القيمة NULL إذا مُرِّرَت معاملات غير صالحة لها.
|
أمثلة
المثال 1: مثال على الدالة array_search()
<?php
$array = array(0 => 'blue', 1 => 'red', 2 => 'green', 3 => 'red');
$key = array_search('green', $array); // $key = 2;
$key = array_search('red', $array); // $key = 1;
?>
انظر أيضًا
- الدالة
array_keys()
: إعادة كافة مفاتيح أو مجموعة فرعية من مفاتيح المصفوفة. - الدالة
array_values()
: إعادة كافة قيم عناصر المصفوفة. - الدالة
array_key_exists()
: التحقق من وجود مفتاح أو مؤشر معين في المصفوفة. - الدالة
in_array()
: التحقق من وجود قيمة ما في مصفوفة.