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

(PHP 4, PHP 5, PHP 7)

تُرتب الدالة rsort()‎‎‎‎‎‎‎‎‎‎‎ مصفوفة بترتيب عكسي.

الوصف

bool rsort ( array &$array [, int $sort_flags = SORT_REGULAR ] )

تُرتب هذه الدالة المصفوفة بترتيب عكسي (من الأعلى إلى الأقل).

ملاحظة: إذا تساوت مقارنة عنصرين، فإن ترتيبهما النسبي في المصفوفة المُرتّبة يكون غير محدد.

المعاملات

array

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

sort_flags

يمكن تعديل طريقة الترتيب باستخدام المعامل الاختياري sort_flags، لمزيد من التفاصيل، راجع الدالة sort()‎.

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

تُعيد الدالة القيمة TRUE عند نجاح عملها أو FALSE عند فشل تنفيذها.

أمثلة

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

<?php
$fruits = array("lemon", "orange", "banana", "apple");
rsort($fruits);
foreach ($fruits as $key => $val) {
    echo "$key = $val\n";
}
?>

سوف تكون مُخرجات المثال أعلاه كالتالي:

0 = orange
1 = lemon
2 = banana
3 = apple

رُتِبت المصفوفة fruits بترتيب هجائي عكسي.

ملاحظات

ملاحظة: تُعيّن هذه الدالة مفاتيح جديدة للعناصر في المصفوفة array. وستزيل أي مفاتيح موجودة قد سبق تعينها، بدلاً من مجرد إعادة ترتيب المفاتيح.

انظر أيضًا

• الدالة arsort()‎: ترتيب عناصر المصفوفة بترتيب عكسي والحفاظ على اقتران الفهارس مع القيم.
• الدالة krsort()‎: ترتيب المصفوفة حسب المفتاح بترتيب عكسي.
• مقارنة بين دوال ترتيب المصفوفة.

مصادر

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