الفرق بين المراجعتين لصفحة: «PHP/end»
< PHP
ط تغيير عنوان الصفحة |
ط نقل عبد اللطيف ايمش صفحة PHP/Function/end إلى PHP/end: إعادة هيكلة التوثيق |
||
| (4 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 4: | سطر 4: | ||
تحرك الدالة <code>end()</code> المؤشر الداخلي للمصفوفة إلى آخر عنصر. | تحرك الدالة <code>end()</code> المؤشر الداخلي للمصفوفة إلى آخر عنصر. | ||
= الوصف = | == الوصف == | ||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
mixed end ( array &$array ) | mixed end ( array &$array ) | ||
</syntaxhighlight>تنقل الدالة <code>end()</code> المؤشر الداخلي للمصفوفة <code>array</code> إلى العنصر الأخير فيها وتعيد قيمته. | </syntaxhighlight>تنقل الدالة <code>end()</code> المؤشر الداخلي للمصفوفة <code>array</code> إلى العنصر الأخير فيها وتعيد قيمته. | ||
= المعاملات = | == المعاملات == | ||
=== <code>array</code> === | === <code>array</code> === | ||
المصفوفة المُدخلة. تُمرر هذه المصفوفة بالمرجعية لأن الدالة تُعدّلها. الأمر الذي يُحتم عليك أن تمرر لها متغيرًا حقيقيًا وليس دالة تُعيد مصفوفة، لأنَّه لا يمكن تمرير غير المتغيرات الفعلية فقط بالمرجعية. | المصفوفة المُدخلة. تُمرر هذه المصفوفة بالمرجعية لأن الدالة تُعدّلها. الأمر الذي يُحتم عليك أن تمرر لها متغيرًا حقيقيًا وليس دالة تُعيد مصفوفة، لأنَّه لا يمكن تمرير غير المتغيرات الفعلية فقط بالمرجعية. | ||
= القيم المعادة = | == القيم المعادة == | ||
تُعيد الدالة قيمة العنصر الأخير، أو القيمة <code>FALSE</code> إذا كانت المصفوفة فارغة. | تُعيد الدالة قيمة العنصر الأخير، أو القيمة <code>FALSE</code> إذا كانت المصفوفة فارغة. | ||
= أمثلة = | == أمثلة == | ||
المثال 1: مثال على الدالة <code>end()</code><syntaxhighlight lang="php"> | المثال 1: مثال على الدالة <code>end()</code><syntaxhighlight lang="php"> | ||
<?php | <?php | ||
| سطر 27: | سطر 27: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
= انظر أيضًا = | == انظر أيضًا == | ||
* الدالة <code>[[PHP | * الدالة <code>[[PHP/current|current()]]</code>: إعادة العنصر الحالي في مصفوفة. | ||
* الدالة <code>[[PHP | * الدالة <code>[[PHP/each|each()]]</code>: إعادة كل من المفتاح والقيمة المقابلة الحاليين من المصفوفة وتحريك مؤشرها الداخلي إلى الأمام. | ||
* الدالة <code>[[PHP | * الدالة <code>[[PHP/reset|reset()]]</code>: ضبط المؤشر الداخلي لمصفوفة على أول عنصر. | ||
* الدالة <code>[[PHP | * الدالة <code>[[PHP/next|next()]]</code>: تحريك المؤشر الداخلي لمصفوفة إلى الأمام. | ||
* الدالة <code>[[PHP | * الدالة <code>[[PHP/prev|prev()]]</code>: إرجاع مؤشر المصفوفة الداخلي إلى الخلف. | ||
= مصادر = | == مصادر == | ||
* [http://php.net/manual/en/function.end.php صفحة الدالة end في توثيق PHP الرسمي]. | * [http://php.net/manual/en/function.end.php صفحة الدالة end في توثيق PHP الرسمي]. | ||
[[تصنيف:PHP]] | [[تصنيف:PHP]] | ||
[[تصنيف:PHP Function]] | [[تصنيف:PHP Function]] | ||
[[تصنيف:PHP Array]] | [[تصنيف:PHP Array]] | ||
المراجعة الحالية بتاريخ 03:49، 4 أبريل 2018
(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(): إرجاع مؤشر المصفوفة الداخلي إلى الخلف.