دالة PHP each()

توابع آرایه در PHP

مثال

يُرجع اسم المفتاح والقيمة للعنصر الحالي ويُتحرك الدليل الداخلي للأمام:

<?php
$people = array("Bill", "Steve", "Mark", "David");
print_r (each($people));
؟>

النموذج العملي

التعريف والاستخدام

تُرجع دالة each() اسم المفتاح والقيمة للعنصر الحالي وتتحرك الدالة الداخلية للأمام.

سيُرجع اسم المفتاح والقيمة للعنصر إلى مجموعة تحتوي على أربعة عناصر. يحتوي العنصران (1 وValue) على القيمة المفتاحية، ويحتوي العنصران (0 وKey) على اسم المفتاح.

الطرق ذات الصلة:

  • current() - يُرجع القيمة الحالية للعنصر في العدد
  • end() - يُوجه الدليل الداخلي إلى العنصر الأخير في العدد ويُطبع
  • next() - يُوجه الدليل الداخلي إلى العنصر التالي في العدد ويُطبع
  • prev() - يُوجه الدليل الداخلي إلى العنصر السابق في العدد ويُطبع
  • reset() - يُوجه الدليل الداخلي إلى العنصر الأول في العدد ويُطبع

النحو

each(array)
المعلمات وصف
array مطلوب. يحدد العدد الذي سيتم استخدامه.

شرح

تقوم دالة each() بإنشاء مجموعة تحتوي على اسم المفتاح والقيمة للعنصر الحالي الذي يشير إليه الدليل الداخلي، وتتحرك الدالة الداخلية للأمام.

تتضمن المجموعة المُرجعة أربعة عناصر: المفتاح 0، 1، key، وvalue. يحتوي وحدة 0 وkey على اسم مفتاح الوحدة، ويحتوي 1 وvalue على البيانات.

إذا تجاوز الدليل الداخلي نطاق العدد، فإن الدالة تعود FALSE.

تفاصيل تقنية

القيمة المُرجعة:

يُرجع المفتاح والقيمة الحالية للعنصر. يتم إرجاع اسم المفتاح والقيمة إلى مجموعة تحتوي على أربعة عناصر.

يحتوي العنصران (1 وValue) على القيمة المفتاحية، ويحتوي العنصران (0 وKey) على اسم المفتاح.

إذا لم يكن هناك عناصر أكثر للعدد، فإن الدالة تعود FALSE.
إصدار PHP: 4+

مزيد من الأمثلة

مثال 1

النموذج المماثل لقمة الصفحة، ولكن في هذا المثال يتم إخراج كامل اللوحة بشكل دائري:

<?php
$people = array("Bill", "Steve", "Mark", "David");
reset($people);
while (list($key, $val) = each($people))
  {
  echo "$key => $val<br>";
  }
؟>

النموذج العملي

مثال 2

أظهر جميع الطرق ذات الصلة:

<?php
$people = array("Bill", "Steve", "Mark", "David");
echo current($people) . "<br>"; // العنصر الحالي هو بيل
echo next($people) . "<br>"; // العنصر التالي لبيل هو ستيف
echo current($people) . "<br>"; // العنصر الحالي الآن هو ستيف
echo prev($people) . "<br>"; // العنصر السابق لستيف هو بيل
echo end($people) . "<br>"; // العنصر الأخير هو ديفيد
echo prev($people) . "<br>"; // العنصر السابق لديفيد هو مارك
echo current($people) . "<br>"; // العنصر الحالي هو مارك
echo reset($people) . "<br>"; // يتحرك المؤشر الداخلي إلى العنصر الأول في اللوحة، أي بيل
echo next($people) . "<br>"; // العنصر التالي لبيل هو ستيف
print_r (each($people); // يعود إلى اسم المفتاح والقيمة الحالية للعنصر (حاليًا هو Steve) ويقوم بالتحرك نحو الأمام في المؤشر الداخلي
؟>

النموذج العملي

توابع آرایه در PHP