الفرق بين المراجعتين ل"PHP/array push"
Khaled-yassin (نقاش | مساهمات) ط (←انظر أيضًا: تنسيق) |
ط (نقل عبد اللطيف ايمش صفحة PHP/Function/array-push إلى PHP/array push: إعادة هيكلة التوثيق) |
||
| (4 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
| − | <noinclude>{{DISPLAYTITLE:<code>array_push()</code>}}</noinclude> | + | <noinclude>{{DISPLAYTITLE:<code>array_push()</code>}}</noinclude> |
(PHP 4, PHP 5, PHP 7) | (PHP 4, PHP 5, PHP 7) | ||
| سطر 7: | سطر 7: | ||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
int array_push ( array &$array , mixed $value1 [, mixed $... ]) | int array_push ( array &$array , mixed $value1 [, mixed $... ]) | ||
| − | </syntaxhighlight>تعامل الدالة <code>array_push()</code> المصفوفة <code>array</code> كمكدس (stack)، وتدفع المتغيرات التي مررناها إلى نهاية المصفوفة <code>array</code> وسيزداد طولها بعدد المتغيرات التي | + | </syntaxhighlight>تعامل الدالة <code>array_push()</code> المصفوفة <code>array</code> كمكدس (stack)، وتدفع المتغيرات التي مررناها إلى نهاية المصفوفة <code>array</code> وسيزداد طولها بعدد المتغيرات التي أضفناها. ولها نفس تأثير الشيفرة الآتية:<syntaxhighlight lang="php"> |
<?php | <?php | ||
$array[] = $var; | $array[] = $var; | ||
| سطر 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>: إضافة عنصر واحد أو أكثر إلى بداية المصفوفة. |
== مصادر == | == مصادر == | ||
| − | * [http://php.net/manual/en/function.array-push.php صفحة الدالة | + | * [http://php.net/manual/en/function.array-push.php صفحة الدالة array_push في توثيق PHP الرسمي]. |
[[تصنيف:PHP]] | [[تصنيف:PHP]] | ||
[[تصنيف:PHP Function]] | [[تصنيف:PHP Function]] | ||
[[تصنيف:PHP Array]] | [[تصنيف:PHP Array]] | ||
المراجعة الحالية بتاريخ 03:49، 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(): إضافة عنصر واحد أو أكثر إلى بداية المصفوفة.