عرض مصدر PHP/array slice

<noinclude>{{DISPLAYTITLE:<code>array_slice()‎</code>}}</noinclude>
(PHP 4, PHP 5, PHP 7)

تستخرج الدالة <code>array_slice()</code>‎ قسمًا من المصفوفة.

== الوصف ==
<syntaxhighlight lang="php">
array array_slice ( array $array , int $offset [, int $length = NULL [, bool $preserve_keys = FALSE ]] )
</syntaxhighlight>تعيد الدالة <code>array_slice()</code>‎ مجموعة من العناصر المتتابعة من المصفوفة <code>array</code> كما هو محدد بواسطة المعاملَيْن <code>offset</code> و<code>length</code>.

== المعاملات ==

=== <code>array</code> ===
المصفوفة المُدخلة.

=== <code>offset</code> ===
إذا كان معامل الإزاحة <code>offset</code> غير سالب، فستبدأ إزاحة التتابع من بداية المصفوفة <code>array</code>. أما إذا كان <code>offset</code> سالبًا، فستبدأ إزاحة التتابع من نهاية المصفوفة <code>array</code> .

=== <code>length</code> ===
إذا كان معامل الطول <code>length</code> موجبًا، فسيكون عدد العناصر المتتابعة مساوٍ له. وإذا كانت المصفوفة أقصر من <code>length</code>، فستُعيد عناصر المصفوفة المتوفرة فقط. وإذا كان <code>length</code> سالبًا، فسيتوقف التتابع عند هذا العدد من العناصر تنازليًا من نهاية المصفوفة. أما إذا لم تُحدَّد قيمة هذا المعامل الاختياري فسيكون التتابع مكونًا من كل العناصر بدءًا من <code>offset</code> وحتى نهاية المصفوفة <code>array</code>.

=== <code>preserve_keys</code> ===
لاحظ أن الدالة <code>array_slice()</code>‎ ستعيد ترتيب وتعيين مؤشرات المصفوفة الرقمية افتراضيًا. لكن يمكننا تغيير هذا السلوك بضبط قيمة المعامل <code>preserve_keys</code> إلى القيمة <code>TRUE</code>.

== القيم المعادة ==
تُعيد الدالة قسمًا من المصفوفة. وإذا كان معامل الإزاحة أكبر من حجم المصفوفة، فستعيد الدالة مصفوفة فارغة.

== سجل التغييرات ==
{| class="wikitable"
!الإصدار
!الوصف
|-
|5.2
|تغيير القيمة الافتراضية لمعامل الطول <code>length</code> إلى القيمة <code>NULL</code>. يجعل اختيار معامل الطول <code>length</code> بالقيمة <code>NULL</code> الدالة تستخدم طول المصفوفة <code>array</code> بالكامل. قبل هذا الإصدار، كان اختيار <code>length</code> بالقيمة <code>NULL</code> يعني طولًا صفريًا (أي لن تعيد الدالة أي شيء).
|-
|5.0.2
|اضافة معامل <code>preserve_keys</code> الاختياري.
|}

== أمثلة ==
المثال 1: أمثلة على الدالة <code>array_slice()</code>‎<syntaxhighlight lang="php">
<?php
$input = array("a", "b", "c", "d", "e");
$output = array_slice($input, 2);      // تعيد "c", "d", و "e"
$output = array_slice($input, -2, 1);  // تعيد "d"
$output = array_slice($input, 0, 3);   // تعيد "a", "b", و "c"
/ / لاحظ الاختلافات في مفاتيح المصفوفة
print_r(array_slice($input, 2, -1));
print_r(array_slice($input, 2, -1, true));
?>
</syntaxhighlight>سوف تكون مُخرجات المثال أعلاه كالتالي:<syntaxhighlight lang="php">
Array
(
    [0] => c
    [1] => d
)
Array
(
    [2] => c
    [3] => d
)
</syntaxhighlight>

== انظر أيضًا ==
* الدالة <code>[[PHP/array_splice|array_splice()]]</code>‎: إزالة جزء من المصفوفة واستبداله بشيء آخر.
* الدالة <code>[[PHP/array_unset|unset()]]</code>‎: إلغاء تعيين متغير معين.
* الدالة <code>[[PHP/array_chunk|array_chunk()]]</code>‎: تقسيم مصفوفة إلى قطع.

== مصادر ==
* [http://php.net/manual/en/function.array-slice.php صفحة الدالة array_slice في توثيق PHP الرسمي].
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Array]]