مثال
در یک آرایه مقدار "red" را جستجو کنید و کلید آن را برگردانید:
$a=array("a"=>"red","b"=>"سبز","c"=>"آبی");
echo array_search("red",$a);
?>
این را خودتان امتحان کنید »
تعریف و استفاده
تابع ()array_search یک آرایه را برای یک مقدار جستجو می کند و کلید را برمی گرداند.
نحو
آرایه_جستجو (مقدار، آرایه، سخت)
مقادیر پارامتر
| پارامتر | توضیح |
|---|---|
| مقدار | لازم است. مقدار جستجوی | را مشخص می کند
| آرایه | لازم است. آرایه ای را برای جستجو در | مشخص می کند
| سخت | اختیاری. اگر این پارامتر روی TRUE تنظیم شود، این تابع عناصر یکسان را در آرایه جستجو می کند. مقادیر ممکن:
وقتی روی true تنظیم شود، عدد 5 با رشته 5 یکسان نیست (به مثال 2 مراجعه کنید) |
جزئیات فنی
| مقدار بازگشتی: | کلید یک مقدار را اگر در آرایه یافت شود، و در غیر این صورت FALSE را برمیگرداند. اگر مقدار بیش از یک بار در آرایه یافت شود، اولین کلید منطبق برگردانده می شود. |
|---|---|
| نسخه PHP: | 4.0.5+ |
| تغییر PHP: | اگر پارامترهای نامعتبر به آن ارسال شوند، این تابع NULL را برمیگرداند (این برای همه توابع PHP از 5.3.0 اعمال میشود). از PHP 4.2.0، این تابع در صورت شکست به جای NULL، FALSE را برمیگرداند. . |
نمونه های بیشتر
مثال
یک آرایه را برای مقدار 5 جستجو کنید و کلید آن را برگردانید (به "" توجه کنید):
$a=array("a"=>"5"،"b"=>5,"c"=>"5");
echo array_search(5,$a,true);
?>
این را خودتان امتحان کنید »
❮ مرجع آرایه PHP