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