الفرق بين المراجعتين لصفحة: «PHP/array push»
ط استبدال النص - 'PHP/Function/array' ب'PHP/array' |
ط استبدال النص - 'PHP\/([^|-]*)-([^|-]*)' ب'PHP/$1_$2' |
||
| سطر 46: | سطر 46: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* <code>[[PHP/ | * <code>[[PHP/array_pop|array_pop()]]</code>: إزالة العنصر الأخير في نهاية المصفوفة وإعادة قيمته. | ||
* <code>[[PHP/ | * <code>[[PHP/array_shift|array_shift()]]</code>: إزالة عنصر من بداية المصفوفة وإعادة قيمته. | ||
* <code>[[PHP/ | * <code>[[PHP/array_unshift|array_unshift()]]</code>: إضافة عنصر واحد أو أكثر إلى بداية المصفوفة. | ||
== مصادر == | == مصادر == | ||
مراجعة 03:46، 4 أبريل 2018
(PHP 4, PHP 5, PHP 7)
تدفع الدالة array_push() عنصرًا واحدًا أو أكثر إلى نهاية المصفوفة.
الوصف
int array_push ( array &$array , mixed $value1 [, mixed $... ])
تعامل الدالة array_push() المصفوفة array كمكدس (stack)، وتدفع المتغيرات التي مررناها إلى نهاية المصفوفة array وسيزداد طولها بعدد المتغيرات التي أضفناها. ولها نفس تأثير الشيفرة الآتية:
<?php
$array[] = $var;
?>
مع تكرارها لكل قيمة يتم إدخالها.
ملاحظة: إذا كنت تستخدم array_push() لإضافة عنصر واحد إلى المصفوفة، فمن الأفضل استخدام $array[] = لأن هذه الطريقة توفر حِمل استدعاء دالة.
ملاحظة : سوف تصدر array_push() تحذيرًا إذا لم يكن الوسيط الأول مصفوفةً. ويختلف هذا عن سلوك $var[] إذ سيُنشِئ مصفوفةً جديدةً.
المعاملات
array
المصفوفة المُدخلة.
value1
القيمة الأولى المراد إدخالها في نهاية المصفوفة array.
القيم المُعادة
تُعيد الدالة array_push() عدد العناصر الجديدة في المصفوفة.
أمثلة
مثال 1: مثال على الدالة array_push()
<?php
$stack = array("orange", "banana");
array_push($stack, "apple", "raspberry");
print_r($stack);
?>
سوف تكون مُخرجات المثال أعلاه كالتالي:
Array
(
[0] => orange
[1] => banana
[2] => apple
[3] => raspberry
)
انظر أيضًا
array_pop(): إزالة العنصر الأخير في نهاية المصفوفة وإعادة قيمته.array_shift(): إزالة عنصر من بداية المصفوفة وإعادة قيمته.array_unshift(): إضافة عنصر واحد أو أكثر إلى بداية المصفوفة.