ابحث في المصفوفة عن المفتاح "الأحمر" وأرجع اسم المفتاح الخاص به:
<?php$a=array("a"=>"red"،"b"=>"green"،"c"=>"blue");echo array_search("red",$a);?>تبحث الدالة array_search() عن قيمة مفتاح في المصفوفة وترجع اسم المفتاح المقابل.
array_search ( قيمة، صفيف، صارم )
| المعلمة | يصف |
|---|---|
| قيمة | مطلوب. يحدد القيمة الأساسية للبحث عنها في المصفوفة. |
| صفيف | مطلوب. يحدد المصفوفة المراد البحث فيها. |
| حازم | خياري. إذا تم تعيين هذه المعلمة على TRUE، فستبحث الدالة في المصفوفة عن العناصر التي لها نفس نوع البيانات والقيمة. القيم المحتملة: حقيقي كاذبة - افتراضية إذا تم التعيين على true، فسيتم التحقق من نوع القيمة المحددة في المصفوفة وسيكون الرقم 5 والسلسلة 5 مختلفين (انظر المثال 2). |
| قيمة الإرجاع: | إذا تم العثور على قيمة المفتاح المحددة في المصفوفة، فسيتم إرجاع اسم المفتاح المقابل، وإلا فسيتم إرجاع FALSE. إذا تم العثور على قيمة مفتاح أكثر من مرة في المصفوفة، فسيتم إرجاع اسم المفتاح المطابق لقيمة المفتاح التي تم العثور عليها لأول مرة. |
|---|---|
| نسخة PHP: | 4.0.5+ |
| سجل التحديث: | إذا تم تمرير معلمات غير صالحة إلى الدالة، فسترجع الدالة NULL (ينطبق هذا على جميع دوال PHP منذ PHP 5.3.0). اعتبارًا من الإصدار PHP 4.2.0، إذا فشل البحث، تقوم هذه الدالة بإرجاع FALSE بدلاً من NULL. |
ابحث عن قيمة المفتاح 5 في المصفوفة وأرجع اسم المفتاح الخاص بها (لاحظ ""):
<?php$a=array("a"=>"5",b"=>5,"c"=>"5");echo array_search(5,$a,true);?>