تابع array_slice() PHP
مثال
از عنصر سوم آرایه شروع به گرفتن می‌کند و بقیه عناصر آرایه را بازمی‌گرداند:
<?php
$a=array("red","green","blue","yellow","brown");
print_r(array_slice($a,2));
?>
تعریف و استفاده
تابع array_slice() عناصر مورد نظر را از آرایه بر اساس شرایط مشخص می‌کند و بازمی‌گرداند.
توضیحات:اگر آرایه دارای کلید‌های استرینگ باشد، آرایه بازگردانده شده نام‌کلید‌ها را حفظ می‌کند. (به مثال 4 مراجعه کنید)
قانون
array_slice(array,شروع,length,محافظت)
| پارامتر | وصف |
|---|---|
| array | ضروری. آرایه را مشخص می‌کند. |
| شروع |
ضروری. عددی. موقعیت شروع برای گرفتن عناصر را مشخص می‌کند. 0 = عنصر اول. اگر این مقدار مثبت باشد، از جلو به عقب شروع می‌شود. اگر این مقدار منفی باشد، از عقب به جلو به مقدار absolute value از start استفاده می‌شود. -2 به این معناست که از دومین عنصر به عقب از آرایه شروع می‌شود. |
| length |
اختیاری. عددی. طول آرایه‌ای که باید بازگردانده شود را مشخص می‌کند. اگر این مقدار عددی باشد، تعداد مشخص شده از عناصر برگردانده می‌شود. اگر این مقدار منفی باشد، فنکشن در این فاصله از انتهای آرایه متوقف می‌شود. اگر این مقدار تنظیم نشده باشد، تمام عناصر از موقعیت تنظیم شده توسط پارامتر start تا انتهای آرایه برگردانده می‌شود. |
| محافظت |
اختیاری. تعیین می‌کند که فنکشن نام‌های کلید را حفظ می‌کند یا تنظیم می‌کند. مقادیر ممکن:
|
جزئیات فنی
| مقدار بازگشتی: | بخشی از آرایه را برگرداند. |
| نسخه PHP: | 4+ |
| گزارش تغییرات: | در PHP 5.0.2 اضافه شد محافظت پارامتر. |
مثال‌های بیشتر
مثال 1
از عنصر دوم آرایه شروع کرده و تنها دو عنصر را برگرداند:
<?php
$a=array("red","green","blue","yellow","brown");
print_r(array_slice($a,1,2));
?>
مثال 2
استفاده از منفی شروع پارامترها:
<?php
$a=array("red","green","blue","yellow","brown");
print_r(array_slice($a,-2,1));
?>
مثال 3
ب محافظت پارامتر تنظیم به true:
<?php
$a=array("red","green","blue","yellow","brown");
print_r(array_slice($a,1,2,true));
?>
مثال 4
پردازش نام‌های کلید استرینگ و عددی:
<?php
$a=array("a"=>"red","b"=>"green","c"=>"blue","d"=>"yellow","e"=>"brown");
print_r(array_slice($a,1,2));
$a=array("0"=>"red","1"=>"green","2"=>"blue","3"=>"yellow","4"=>"brown");
print_r(array_slice($a,1,2));
?>
