PHP/arsort

(PHP 4, PHP 5, PHP 7)

تُرتَّب الدالة ()‎arsort عناصر المصفوفة بترتيب عكسي، وتحافظ على اقتران الفهارس مع القيم المرتبطة بها.

الوصف

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

تُرتّب الدالة ()‎arsort عناصر المصفوفة مع الحفاظ على اقتران فهارس عناصر هذه المصفوفة والقيم المرتبطة بها.

وتُستخدم هذه الدالة بشكل أساسي عند ترتيب المصفوفات الترابطية والتي يكون ترتيب العناصر الفعلي فيها مهمًا.

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

المعاملات

array

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

sort_flags

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

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

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

أمثلة

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

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

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

a = orange
d = lemon
b = banana
c = apple

رُتِبت المصفوفة fruits بترتيب هجائي معكوس، وحُوفِظ على الفهرس المقترن بكل قيمة.

انظر أيضًا

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

مصادر

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