الفرق بين المراجعتين ل"PHP/current"
< PHP
اذهب إلى التنقل
اذهب إلى البحث
Khaled-yassin (نقاش | مساهمات) ط (←انظر أيضًا) |
ط (نقل عبد اللطيف ايمش صفحة PHP/Function/current إلى PHP/current: إعادة هيكلة التوثيق) |
||
| (8 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 1: | سطر 1: | ||
| − | <noinclude>{{DISPLAYTITLE:<code>current() | + | <noinclude>{{DISPLAYTITLE:الدالة <code>current()</code> في PHP}}</noinclude> |
(PHP 4, PHP 5, PHP 7) | (PHP 4, PHP 5, PHP 7) | ||
تعيد الدالة <code>current()</code> العنصر الحالي في مصفوفة. | تعيد الدالة <code>current()</code> العنصر الحالي في مصفوفة. | ||
| − | = الوصف = | + | == الوصف == |
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
mixed current ( array $array ) | mixed current ( array $array ) | ||
</syntaxhighlight>تحتوي كل مصفوفة على مؤشر داخلي يشير إلى العنصر "الحالي"، والذي يشير بدايةً إلى العنصر الأول المدرج في المصفوفة. | </syntaxhighlight>تحتوي كل مصفوفة على مؤشر داخلي يشير إلى العنصر "الحالي"، والذي يشير بدايةً إلى العنصر الأول المدرج في المصفوفة. | ||
| − | = المعاملات = | + | == المعاملات == |
=== <code>array</code> === | === <code>array</code> === | ||
المصفوفة المُدخلة. | المصفوفة المُدخلة. | ||
| − | = القيم المعادة = | + | == القيم المعادة == |
تُعيد الدالة <code>current()</code> ببساطة قيمة عنصر المصفوفة الذي يشير إليه حاليًا المؤشرُ الداخلي. ولا تحرك الدالةُ المؤشرَ بأي طريقة. إذا كان المؤشر الداخلي يشير إلى ما بعد نهاية قائمة العناصر، أو إذا كانت المصفوفة فارغة، فإن الدالة <code>current()</code> تعيد القيمة <code>FALSE</code>. | تُعيد الدالة <code>current()</code> ببساطة قيمة عنصر المصفوفة الذي يشير إليه حاليًا المؤشرُ الداخلي. ولا تحرك الدالةُ المؤشرَ بأي طريقة. إذا كان المؤشر الداخلي يشير إلى ما بعد نهاية قائمة العناصر، أو إذا كانت المصفوفة فارغة، فإن الدالة <code>current()</code> تعيد القيمة <code>FALSE</code>. | ||
| − | تحذير: قد تُعيد هذه الدالة القيمة المنطقية <code>FALSE</code>، ولكن قد تُعيد أيضًا قيمة غير منطقية تُقيّم بنفس القيمة <code>FALSE</code>. يرجى قراءة قسم القيم المنطقية [[PHP | + | تحذير: قد تُعيد هذه الدالة القيمة المنطقية <code>FALSE</code>، ولكن قد تُعيد أيضًا قيمة غير منطقية تُقيّم بنفس القيمة <code>FALSE</code>. يرجى قراءة قسم القيم المنطقية [[PHP/boolean|Booleans]] لمزيد من المعلومات. ويستخدم [[PHP/comparison operators|العامل ===]] لاختبار القيمة المعادة من هذه الدالة. |
| − | = سجل التغييرات = | + | == سجل التغييرات == |
{| class="wikitable" | {| class="wikitable" | ||
!الإصدار | !الإصدار | ||
| سطر 28: | سطر 28: | ||
|} | |} | ||
| − | = أمثلة = | + | == أمثلة == |
المثال 1: مثال على الدالة <code>current()</code> وما شابهها<syntaxhighlight lang="php"> | المثال 1: مثال على الدالة <code>current()</code> وما شابهها<syntaxhighlight lang="php"> | ||
<?php | <?php | ||
| سطر 47: | سطر 47: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | = ملاحظات = | + | == ملاحظات == |
| − | ملاحظة : لا يمكن تمييز كلًا من نهاية المصفوفة ونتيجة استدعاء الدالة <code>current()</code> على مصفوفة فارغة عن عنصر منطقي يحمل القيمة <code>FALSE</code>. للمرور بشكل صحيح عبر مصفوفة قد تحتوي على عناصر قيمتها <code>FALSE</code>، راجع الدالة <code>[[PHP | + | ملاحظة : لا يمكن تمييز كلًا من نهاية المصفوفة ونتيجة استدعاء الدالة <code>current()</code> على مصفوفة فارغة عن عنصر منطقي يحمل القيمة <code>FALSE</code>. للمرور بشكل صحيح عبر مصفوفة قد تحتوي على عناصر قيمتها <code>FALSE</code>، راجع الدالة <code>[[PHP/foreach|foreach()]]</code>. للاستمرار في استخدام <code>current()</code> والتحقق بشكل صحيح إذا كانت القيمة تُعد عنصرًا من المصفوفة، يجب التحقق من <code>[[PHP/key|key()]]</code> العنصر الحالي <code>current()</code> ليصبح مختلفًا تمامًا عن <code>NULL</code>. |
== انظر أيضًا == | == انظر أيضًا == | ||
| − | * الدالة <code>[[PHP | + | * الدالة <code>[[PHP/end|end()]]</code>: ضبط المؤشر الداخلي لمصفوفة على آخر عنصر. |
| − | * الدالة <code>[[PHP | + | * الدالة <code>[[PHP/key|key()]]</code>: جلب مفتاح من مصفوفة. |
| − | * الدالة <code>[[PHP | + | * الدالة <code>[[PHP/each|each()]]</code>: إعادة كلًا من المفتاح والقيمة المقابلة الحاليين من المصفوفة وتحريك مؤشرها للأمام. |
| − | * الدالة <code>[[PHP | + | * الدالة <code>[[PHP/prev|prev()]]</code>: إرجاع مؤشر المصفوفة الداخلي إلى الخلف. |
| − | * الدالة <code>[[PHP | + | * الدالة <code>[[PHP/reset|reset()]]</code>: تحريك المؤشر الداخلي لمصفوفة إلى أول عنصر. |
| − | * الدالة <code>[[PHP | + | * الدالة <code>[[PHP/next|next()]]</code>: تحريك المؤشر الداخلي لمصفوفة إلى الأمام. |
| − | = مصادر = | + | == مصادر == |
* [http://php.net/manual/en/function.current.php صفحة الدالة current في توثيق PHP الرسمي]. | * [http://php.net/manual/en/function.current.php صفحة الدالة current في توثيق PHP الرسمي]. | ||
[[تصنيف:PHP]] | [[تصنيف:PHP]] | ||
[[تصنيف:PHP Function]] | [[تصنيف:PHP Function]] | ||
[[تصنيف:PHP Array]] | [[تصنيف:PHP Array]] | ||
المراجعة الحالية بتاريخ 03:49، 4 أبريل 2018
(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(): تحريك المؤشر الداخلي لمصفوفة إلى الأمام.