جستجو (array_search)
تابع «array_search» برای «جستجوی آرایه» استفاده می شود. این تابع مقدار را در آرایه می گردد و کلیدش را برمی گرداند. مثل وقتی در لیست حضور کلاس اسم دوستت را پیدا می کنی و شماره اش را می نویسی.
تعریف و کاربرد جستجوی آرایه
array_search در آرایه دنباله یک مقدار می گردد و کلید همان مقدار را برمی گرداند. اگر مقدار تکراری باشد، اولین کلید برگردانده می شود.
سینتکس (Syntax)
array_search($value, $array, $strict);
نکته: پارامتر strict یعنی «یکسان بودن کامل (Identical)». عدد 5 با رشته "5" متفاوت است.
مثال 1: پیدا کردن کلید مقدار
در این مثال، مقدار "red" جستجو می شود و کلیدش چاپ می شود.
<?php
$a = array("a" => "red", "b" => "green", "c" => "blue");
echo array_search("red", $a);
?>
مثال 2: حالت strict و مقایسه یکسان
وقتی true بدهی، نوع ها هم باید یکسان باشند. پس 5 با "5" یکی نیست.
<?php
$a = array("a" => "5", "b" => 5, "c" => "5");
echo array_search(5, $a, true);
?>
جزئیات فنی کوتاه
خروجی، کلید مقدارِ یافت شده است؛ در غیر این صورت FALSE. اگر چند بار باشد، اولین کلید برمی گردد. نسخه PHP: 4.0.5+.
لینک های داخلی مفید
برای مرور سریع جستجوی آرایه را نشانه گذاری کن. همچنین ببین array_reverse برای نمایش معکوس و array_reduce برای خلاصه سازی.
جمع بندی سریع
- array_search کلید یک مقدار را می دهد.
- در تکراری ها، اولین کلید برمی گردد.
- با strict، نوع ها باید یکسان باشند.
- نیافتن مقدار یعنی FALSE برمی گردد.