الدالة next() في PHP
(PHP 4, PHP 5, PHP 7)
تحرك الدالة next() المؤشر الداخلي للمصفوفة إلى الأمام.
الوصف
mixed next ( array &$array )
تتصرف الدالة next() بنفس طريقة الدالة current() مع فارق واحد. يتقدم مؤشر المصفوفة الداخلي مكان واحد إلى الأمام قبل إعادة قيمة العنصر. وهذا يعني أنها تعيد قيمة العنصر التالي من المصفوفة وتنقل مؤشر المصفوفة الداخلي بمقدار مكان واحد للأمام.
المعاملات
array
المصفوفة المُدخلة.
القيم المعادة
تُعيد الدالة قيمة عنصر المصفوفة في المكان التالي والذي يشير إليه مؤشر المصفوفة الداخلي، أو FALSE إذا لم تكن هناك عناصر أخرى.
تحذير : قد تُعيد هذه الدالة القيمة المنطقية FALSE، ولكن قد تُعيد أيضًا قيمة غير منطقية تُقيّم بنفس القيمة FALSE. يرجى قراءة قسم القيم المنطقية Booleans لمزيد من المعلومات. ويستخدم العامل === لاختبار القيمة المعادة من هذه الدالة.
أمثلة
المثال 1: مثال على استخدام الدالة next() وما شابهها.
<?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';
?>
ملاحظات
ملاحظة: لا يمكن تمييز نهاية المصفوفة عن عنصر منطقي يحمل القيمة FALSE. للمرور بشكل صحيح عبر مصفوفة قد تحتوي على عناصر قيمتها FALSE، راجع الحلقة foreach. للاستمرار في استخدام next() بشكل صحيح من الوصول إلى نهاية المصفوفة، يجب التحقق من أن مُخرج الدالة key() يساوي NULL.
انظر أيضًا
- الدالة
current(): إعادة قيمة العنصر الحالي في مصفوفة. - الدالة
end(): ضبط المؤشر الداخلي لمصفوفة إلى آخر عنصر. - الدالة
prev(): إرجاع مؤشر المصفوفة الداخلي إلى الخلف. - الدالة
reset(): تحريك المؤشر الداخلي لمصفوفة إلى أول عنصر. - الدالة
each(): إعادة كلًا من المفتاح والقيمة المقابلة الحاليين من المصفوفة وتحريك مؤشرها للأمام.