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