PHP array_search() فونکشن

توابع آرایه پی‌ایچ‌پی

مثال

آرایے میں کلید مقادیر "red" کو تلاش کرنا، اور اس کا کلید نام واپس فراہم کرنا:

<?php
$a=array("a"=>"red","b"=>"green","c"=>"blue");
echo array_search("red",$a);
?>

مثال اجرایی

تعریف اور استعمال

array_search() فونکشن اپنے آرایے میں کسی کلید مقادیر کو تلاش کرتا ہے، اور اس کا کلید نام واپس فراہم کرتا ہے。

تفصیلات میں کافی تفصیلات دیئے گئی ہیں

array_search() فونکشن اور in_array() ایک طرح میں ایک کلید مقادیر جستجو کرنا، اگر اس مقادیر کو پائیا تو ان کا کلید نام واپس فراہم کیا جائے گا، اگر نہ پائیا تو false واپس فراہم کیا جائے گا。

قبل از PHP 4.2.0، این فنکشن در صورت شکست null را بازمی‌گرداند، نه false.

اگر پارامتر سوم strict اگر تنظیم به true شود، تنها در صورتی که نوع داده و مقدار داده‌ای مشابه باشند، نام کلید مربوطه را بازمی‌گرداند.

نحوه استفاده

array_search(value,array,strict)
پارامتر توضیح
value ضروری. کلیدمقداری که باید جستجو شود را مشخص می‌کند.
array ضروری. آرایه‌ای که باید جستجو شود را مشخص می‌کند.
strict

اختیاری. اگر این پارامتر به TRUE تنظیم شود، فنکشن در آرایه دنبال داده‌ای است که نوع داده و مقدار داده‌ای مشابه باشد.

  • true
  • false - پیش‌فرض

اگر تنظیم به true شود، در آرایه به نوع داده و مقدار داده‌ای که داده شده است، بررسی می‌شود، عدد 5 و رشته 5 متفاوت هستند (لطفاً به مثال 2 مراجعه کنید).

جزئیات فنی

مقدار بازگشتی:

اگر کلیدمقدار مشخصی در آرایه یافت شود، نام کلید مرتبط را بازمی‌گرداند، در غیر این صورت FALSE را بازمی‌گرداند.

اگر در آرایه کلیدمقدار بیش از یک بار یافت شود، کلید اولین یافت شده را بازمی‌گرداند.
نسخه PHP: 4.0.5+
گزارش به‌روزرسانی:

اگر پارامترهای نامعتبر به فنکشن ارسال شود، فنکشن NULL را بازمی‌گرداند (این برای تمام فنکشن‌های PHP از PHP 5.3.0 به بعد صدق می‌کند).

از PHP 4.2.0 به بعد، اگر جستجو شکست بخورد، این فنکشن FALSE را بازمی‌گرداند، نه NULL.

مثال‌های بیشتر

مثال 1

در آرایه دنبال کلیدمقدار 5 می‌گردد و نام کلید را بازمی‌گرداند (توجه داشته باشید ""):

<?php
$a=array("a"=>"5","b"=>5,"c"=>"5");
echo array_search(5,$a,true);
?>

مثال اجرایی

توابع آرایه پی‌ایچ‌پی