تابع array_search در PHP
در این بخش به بررسی تابع array_search در PHP می پردازیم، تابع array_search()
یک آرایه را برای یک مقدار جستجو می کند و کلید را برمی گرداند.
مثال
در این مثال کلمه red را جستجو می کنیم که در صورت وجود کلید عنصری که حاوی کلمه red هست برگردانده می شود.
خروجی:
a
تعریف و کاربرد
تابع array_search()
در PHP برای جستجوی یک مقدار خاص در یک آرایه (Array) و یافتن اولین عنصر با مقدار مورد نظر استفاده میشود. اگر مقدار مورد نظر یافت نشود، تابع false
بازمیگرداند.
نحوه استفاده
array_search(value, array, strict)
پارامترها و مقادیر
پارامتر | توضیحات |
---|---|
value | یک مقدار را برای جستجو مشخص می کند. (اجباری) |
array | آرایه را برای جستجو مشخص می کند. (اجباری) |
strict | اگر این پارامتر روی TRUE تنظیم شود، این تابع عناصر یکسان (از نظر نوع/type) را در آرایه جستجو می کند. مقادیری که این پارامتر میگیرد:
به عنوان مثال اگر روی TRUE تنظیم شود عدد ۵ با رشته “۵” یکسان نیست (به مثال های بعدی دقت کنید) |
اطلاعات فنی
مقدار بازگشتی | اگر مقدار مشخص شده در آرایه مورد نظر پیدا شود کلید آن را برمی گرداند در غیر این صورت مقدار FALSE برگردانده می شود. اگر مقدار بیش از یک بار در آرایه یافت شود، کلید اولین تطابق برگردانده خواهد شد. |
---|---|
نسخه PHP | 4.0.5+ |
آخرین تغییرات در PHP | اگر پارامترهای نامعتبر به آن ارسال شوند، این تابع NULL را برمیگرداند (این مورد برای همه توابع PHP از 5.3.0 اعمال میشود). از PHP 4.2.0، این تابع در صورت شکست به جای NULL، FALSE را برمی گرداند. |
مثال های بیشتر
در این مثال عدد 5 را جستجو می کنیم و مقدار کلید آن را برمی گردانیم.
خروجی:
b
آیا این مطلب برای شما مفید بود ؟