تابع ()array_search

چاپ

تابع ()array_search 

PHP Array Referenceمرجع Array در php

مثال (تابع ()array_search)

جستجوی یک آرایه برای یافتن مقدار "red" و برگرداندن کلید آن:

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

امتحان کنید »

تعریف و کاربرد

تابع ()array_search یک آرایه را برای یافتن یک مقدار، جستجو می کند و کلید آن را برمی گرداند:

نحوه نوشتن

array_search(value,array,strict)
پارامترهاتوضیحات
value

ضروری. مقداری که قرار است جستجو کنیم را مشخص می کند.
array

ضروری. آرایه ای که قرار است جستجو درون آن انجام شود را مشخص می کند.
strict

اختیاری. اگر این پارامتر به TRUE ست شود، آنگاه این تابع به جستجوی عناصر یکسان در آرایه ی مورد نظر می پردازد.

مقادیر امکان پذیر:

  • true
  • false -پیش فرض

وقتی که آن را به TRUE ست می کنیم، بعنوان مثال، عدد 5 با رشته ی 5 یکسان نخواهد بود(مثال 2 را مشاهده کنید)

جزئیات تکنیکی

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

کلید یک مقدار را برمی گرداند اگر که در آرایه ی مورد نظر پیدا شود. و در غیر این صورت FALSE را برمی گرداند. اگر که مقدار مورد نظر، بیش از یک بار در آرایه وجود داشته باشد، اولین کلید مورد تطابق برگردانده خواهد شد.
ورژن php: 4.0.5+
تغییرات:

اگر که پارامترهای نامعتبر به این تابع پاس داده شوند، این تابع NULL را برمی گرداند. از PHP 5.3.0 به بعد این به تمام توابع PHP اعمال شده است.

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

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

مثال 1

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

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

امتحان کنید »

PHP Array Referenceمرجع Array در php

نوشته شده توسط احسان عباسی
بازدید: 5497