إزالة عنصر من مصفوفة واستبداله بعنصر جديد:
<?php$a1=array("a"=>"red"،"b"=>"green"،"c"=>"blue"، "d"=>"yellow");$a2=array( "a"=>"أرجواني"،"b"=>"برتقالي");array_splice($a1,0,2,$a2);print_r($a1);?>تقوم الدالة array_splice() بإزالة العنصر المحدد من المصفوفة واستبداله بعنصر جديد. ستقوم الدالة أيضًا بإرجاع مجموعة من العناصر التي تمت إزالتها.
نصيحة: إذا لم تقم الدالة بإزالة أي عناصر (الطول = 0)، فسيتم إدراج المصفوفة البديلة من موضع معلمة البداية (انظر المثال 2).
ملاحظة: لا يتم الاحتفاظ بأسماء المفاتيح في المصفوفات البديلة.
array_splice ( صفيف، بداية، طول، صفيف )
| المعلمة | يصف |
|---|---|
| صفيف | مطلوب. يحدد مصفوفة. |
| يبدأ | مطلوب. القيمة العددية. يحدد موضع البداية للعناصر المحذوفة. 0 = العنصر الأول. إذا تم تعيين القيمة على رقم موجب، فستبدأ الإزالة عند الإزاحة في الصفيف المحدد بواسطة القيمة. إذا تم تعيين القيمة على رقم سالب، فستبدأ الإزالة عند الإزاحة المحددة بواسطة القيمة من نهاية المصفوفة. -2 يعني البدء من العنصر الثاني إلى العنصر الأخير في المصفوفة. |
| طول | خياري. القيمة العددية. يحدد عدد العناصر المراد إزالتها، وهو أيضًا طول المصفوفة التي تم إرجاعها. إذا تم تعيين القيمة على رقم موجب، تتم إزالة هذا العدد من العناصر. إذا تم تعيين هذه القيمة إلى رقم سالب، تتم إزالة كافة العناصر من البداية إلى الطول المتبادل لنهاية المصفوفة. إذا لم يتم تعيين هذه القيمة، تتم إزالة كافة العناصر من الموضع الذي تم تعيينه بواسطة معلمة البداية إلى نهاية المصفوفة. |
| صفيف | خياري. يحدد المصفوفة التي تحتوي على العناصر التي سيتم إدراجها في المصفوفة الأصلية. إذا كان هناك عنصر واحد فقط، فيمكن تعيينه إلى سلسلة ولا يلزم تعيينه إلى مصفوفة. |
| قيمة الإرجاع: | إرجاع مصفوفة تحتوي على العناصر المستخرجة. |
|---|---|
| نسخة PHP: | 4+ |
نفس المثال السابق في هذه الصفحة، ولكن يُخرج المصفوفة التي تم إرجاعها:
<?php$a1=array("a"=>"red"،"b"=>"green"،"c"=>"blue"، "d"=>"yellow");$a2=array( "a"=>"أرجواني"،"b"=>"برتقالي");print_r(array_splice($a1,0,2,$a2));?>مع تعيين معلمة الطول على 0:
<?php$a1=array("0"=>"red",1"=>"green");$a2=array("0"=>"purple",1"=>"برتقالي") ;array_splice($a1,1,0,$a2);print_r($a1);?>