PHP array_slice() 函数

实例

从数组的第三个元素开始取出,并返回数组中的其余元素:

<?php
$a=array("red","green","blue","yellow","brown");
print_r(array_slice($a,2));
?>

اجرای نمونه

定义和用法

array_slice() 函数在数组中根据条件取出一段值,并返回。

注释:如果数组有字符串键,所返回的数组将保留键名。(参见例子 4)

语法

array_slice(array,شروع,length,حفظ)
参数 描述
array 必需。规定数组。
شروع

必需。数值。规定取出元素的开始位置。 0 = 第一个元素。

如果该值设置为正数,则从前往后开始取。

如果该值设置为负数,则从后向前取 start 绝对值。 -2 意味着从数组的倒数第二个元素开始。

length

可选。数值。规定被返回数组的长度。

اگر این مقدار عددی باشد، این تعداد عناصر بازمی‌گردانده می‌شود.

اگر این مقدار منفی باشد، عملکرد در این فاصله از پایان آرایه متوقف می‌شود.

اگر این مقدار تنظیم نشده باشد، تمام عناصر از موقعیت تنظیم شده توسط پارامتر start تا پایان آرایه بازمی‌گردانده می‌شوند.

حفظ

اختیاری. تعیین می‌کند که آیا نام‌های کلید باید حفظ شوند یا حذف شوند. مقادیر ممکن:

  • true - حفظ نام‌های کلید
  • false - پیش‌فرض. نام‌های کلید را حذف کنید

جزئیات فنی

مقدار بازگشتی: بخشی از آرایه را بازمی‌گرداند.
نسخه 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));
?>

اجرای نمونه