الدالة reset() في PHP
(PHP 4, PHP 5, PHP 7)
تُحرك الدالة reset() المؤشر الداخلي لمصفوفة إلى أول عنصر.
الوصف
mixed reset ( array &$array )
تُحرك الدالة reset() المؤشر الداخلي للمصفوفة array إلى لبدايتها. فيها وتُعيد قيمة أول عنصر فيها.
المعاملات
array
المصفوفة المُدخلة.
القيم المعادة
تُعيد الدالة قيمة عنصر المصفوفة الأول، أو FALSE إذا كان المصفوفة فارغةً.
تحذير: قد تُعيد هذه الدالة القيمة المنطقية FALSE، ولكن قد تُعيد أيضًا قيمة غير منطقية تُقيّم بنفس القيمة FALSE. يرجى قراءة قسم القيم المنطقية Booleans لمزيد من المعلومات. ويستخدم العامل === لاختبار القيمة المعادة من هذه الدالة.
أمثلة
المثال 1: مثال على الدالة reset()
<?php
$array = array('step one', 'step two', 'step three', 'step four');
//يكون المؤشر على العنصر الأول افتراضيًا
echo current($array) . "<br />\n"; // "step one"
// تخطي خطوتين
next($array);
next($array);
echo current($array) . "<br />\n"; // "step three"
// إعادة تعيين المؤشر، البدء مرة أخرى من step one
reset($array);
echo current($array) . "<br />\n"; // "step one"
?>
ملاحظات
ملاحظة: لا يمكن تمييز القيمة المُعادة من مصفوفة فارغة عن القيمة المُعادة في حالة كان يحمل أول عناصر المصفوفة القيمةَ المنطقية FALSE. للتحقق بشكل صحيح من أن قيمة العنصر الأول من المصفوفة قد تكون FALSE، تحقق أولاً من الدالة count() للمصفوفة، أو تحقق من أن قيمة الدالة key() ليست NULL، بعد استدعاء الدالة reset().
انظر ايضًا
- الدالة current(): إعادة العنصر الحالي في مصفوفة.
- الدالة each(): إعادة كل من المفتاح والقيمة المقابلة الحاليين من المصفوفة وتحريك مؤشرها للأمام.
- الدالة end(): ضبط المؤشر الداخلي لمصفوفة على آخر عنصر.
- الدالة next(): تحريك المؤشر الداخلي لمصفوفة إلى الأمام.
- الدالة prev(): إرجاع مؤشر المصفوفة الداخلي إلى الخلف.