الدالة end()‎ في PHP

(PHP 4, PHP 5, PHP 7)

تحرك الدالة end()‎ المؤشر الداخلي للمصفوفة إلى آخر عنصر.

الوصف

mixed end ( array &$array )

تنقل الدالة end()‎ المؤشر الداخلي للمصفوفة array إلى العنصر الأخير فيها وتعيد قيمته.

المعاملات

array

المصفوفة المُدخلة. تُمرر هذه المصفوفة بالمرجعية لأن الدالة تُعدّلها. الأمر الذي يُحتم عليك أن تمرر لها متغيرًا حقيقيًا وليس دالة تُعيد مصفوفة، لأنَّه لا يمكن تمرير غير المتغيرات الفعلية فقط بالمرجعية.

القيم المعادة

تُعيد الدالة قيمة العنصر الأخير، أو القيمة FALSE إذا كانت المصفوفة فارغة.

أمثلة

المثال 1: مثال على الدالة end()‎

<?php

$fruits = array('apple', 'banana', 'cranberry');
echo end($fruits); // cranberry

?>

انظر أيضًا

• الدالة current()‎: إعادة العنصر الحالي في مصفوفة.
• الدالة each()‎: إعادة كل من المفتاح والقيمة المقابلة الحاليين من المصفوفة وتحريك مؤشرها الداخلي إلى الأمام.
• الدالة reset()‎: ضبط المؤشر الداخلي لمصفوفة على أول عنصر.
• الدالة next()‎: تحريك المؤشر الداخلي لمصفوفة إلى الأمام.
• الدالة prev()‎: إرجاع مؤشر المصفوفة الداخلي إلى الخلف.

مصادر

• صفحة الدالة end‎ في توثيق PHP الرسمي.