عرض مصدر PHP/next

<noinclude>{{DISPLAYTITLE:الدالة <code>‎‎‎‎‎‎‎‎‎‎next()‎‎‎‎‎‎‎‎</code> في PHP}}</noinclude>
(PHP 4, PHP 5, PHP 7)

تحرك الدالة <code>next()‎‎</code> المؤشر الداخلي للمصفوفة إلى الأمام.

== الوصف ==
<syntaxhighlight lang="php">
mixed next ( array &$array )
</syntaxhighlight>تتصرف الدالة <code>next()‎‎‎‎‎‎‎‎</code> بنفس طريقة الدالة <code>[[PHP/current|current()‎]]</code> مع فارق واحد. يتقدم مؤشر المصفوفة الداخلي مكان واحد إلى الأمام قبل إعادة قيمة العنصر. وهذا يعني أنها تعيد قيمة العنصر التالي من المصفوفة وتنقل مؤشر المصفوفة الداخلي بمقدار مكان واحد للأمام.

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

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

== القيم المعادة ==
تُعيد الدالة قيمة عنصر المصفوفة في المكان التالي والذي يشير إليه مؤشر المصفوفة الداخلي، أو <code>FALSE</code> إذا لم تكن هناك عناصر أخرى.

تحذير : قد تُعيد هذه الدالة القيمة المنطقية <code>FALSE</code>، ولكن قد تُعيد أيضًا قيمة غير منطقية تُقيّم بنفس القيمة <code>FALSE</code>. يرجى قراءة قسم القيم المنطقية [[PHP/boolean|Booleans]] لمزيد من المعلومات. ويستخدم [[PHP/comparison operators|العامل ===]] لاختبار القيمة المعادة من هذه الدالة.

== أمثلة ==
المثال 1: مثال على استخدام الدالة <code>next()‎‎‎‎‎‎‎‎</code> وما شابهها.<syntaxhighlight lang="php">
<?php
$transport = array('foot', 'bike', 'car', 'plane');
$mode = current($transport); // $mode = 'foot';
$mode = next($transport);    // $mode = 'bike';
$mode = next($transport);    // $mode = 'car';
$mode = prev($transport);    // $mode = 'bike';
$mode = end($transport);     // $mode = 'plane';
?>
</syntaxhighlight>

== ملاحظات ==
ملاحظة: لا يمكن تمييز نهاية المصفوفة عن عنصر [[PHP/boolean|منطقي]] يحمل القيمة <code>FALSE</code>. للمرور بشكل صحيح عبر مصفوفة قد تحتوي على عناصر قيمتها <code>FALSE</code>، راجع الحلقة <code>[[PHP/foreach|foreach]]</code>. للاستمرار في استخدام <code>next()‎‎‎‎‎‎‎‎</code> بشكل صحيح من الوصول إلى نهاية المصفوفة، يجب التحقق من أن مُخرج الدالة <code>[[PHP/key|key()‎‎]]</code> يساوي <code>NULL</code>.

== انظر أيضًا ==
* الدالة <code>[[PHP/current|current()‎]]</code>: إعادة قيمة العنصر الحالي في مصفوفة.
* الدالة <code>[[PHP/end|end()‎‎]]</code>: ضبط المؤشر الداخلي لمصفوفة إلى آخر عنصر.
* الدالة <code>[[PHP/prev|prev()‎‎]]</code>: إرجاع مؤشر المصفوفة الداخلي إلى الخلف.
* الدالة <code>[[PHP/reset|reset()‎‎]]</code>: تحريك المؤشر الداخلي لمصفوفة إلى أول عنصر.
* الدالة <code>[[PHP/each|each()‎‎]]</code>: إعادة كلًا من المفتاح والقيمة المقابلة الحاليين من المصفوفة وتحريك مؤشرها للأمام.

== مصادر ==
* [http://php.net/manual/en/function.next.php صفحة الدالة next في توثيق PHP الرسمي].

[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Array]]