PHP/current

(PHP 4, PHP 5, PHP 7)

تعيد الدالة current()‎ العنصر الحالي في مصفوفة.

الوصف

mixed current ( array $array )

تحتوي كل مصفوفة على مؤشر داخلي يشير إلى العنصر "الحالي"، والذي يشير بدايةً إلى العنصر الأول المدرج في المصفوفة.

المعاملات

array

المصفوفة المُدخلة.

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

تُعيد الدالة current()‎ ببساطة قيمة عنصر المصفوفة الذي يشير إليه حاليًا المؤشرُ الداخلي. ولا تحرك الدالةُ المؤشرَ بأي طريقة. إذا كان المؤشر الداخلي يشير إلى ما بعد نهاية قائمة العناصر، أو إذا كانت المصفوفة فارغة، فإن الدالة current()‎ تعيد القيمة FALSE.

تحذير: قد تُعيد هذه الدالة القيمة المنطقية FALSE، ولكن قد تُعيد أيضًا قيمة غير منطقية تُقيّم بنفس القيمة FALSE. يرجى قراءة قسم القيم المنطقية Booleans لمزيد من المعلومات. ويستخدم العامل === لاختبار القيمة المعادة من هذه الدالة.

سجل التغييرات

الإصدار	الوصف
7.0.0	تُمرر المصفوفة array الآن دائمًا كقيمة. قبل هذا الإصدار، كانت تُمرر بالمرجعية إن أمكن، وبالقيمة بخلاف ذلك.

أمثلة

المثال 1: مثال على الدالة current()‎ وما شابهها

<?php
$transport = array('foot', 'bike', 'car', 'plane');
$mode = current($transport); // $mode = 'foot';
$mode = next($transport);    // $mode = 'bike';
$mode = current($transport); // $mode = 'bike';
$mode = prev($transport);    // $mode = 'foot';
$mode = end($transport);     // $mode = 'plane';
$mode = current($transport); // $mode = 'plane';

$arr = array();
var_dump(current($arr)); // bool(false)

$arr = array(array());
var_dump(current($arr)); // array(0) { }
?>

ملاحظات

ملاحظة : لا يمكن تمييز كلًا من نهاية المصفوفة ونتيجة استدعاء الدالة current()‎ على مصفوفة فارغة عن عنصر منطقي يحمل القيمة FALSE. للمرور بشكل صحيح عبر مصفوفة قد تحتوي على عناصر قيمتها FALSE، راجع الدالة foreach()‎. للاستمرار في استخدام current()‎ والتحقق بشكل صحيح إذا كانت القيمة تُعد عنصرًا من المصفوفة، يجب التحقق من key()‎ العنصر الحالي current()‎ ليصبح مختلفًا تمامًا عن NULL.

انظر أيضًا

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

مصادر

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