PHP/uasort

(PHP 4, PHP 5, PHP 7)

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

الوصف

bool uasort ( array &$array , callable $value_compare_func )

تُرتب هذه الدالة المصفوفة وتُحفاظ على ارتباط الفهارس بالقيم المقابلة، وذلك باستخدام دالة مقارنة معرفة من قبل المستخدم.

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

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

المعاملات

array

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

value_compare_func

انظر الدوال usort()‎‎ و uksort()‎‎ للحصول على أمثلة لوظائف المقارنة المعرفة بواسطة المستخدم.

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

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

أمثلة

المثال 1: مثال بسيط للدالة uasort()‎‎

<?php
// دالة المقارنة
function cmp($a, $b) {
   if ($a == $b) {
       return 0;
   }
   return ($a < $b) ? -1 : 1;
}
// المصفوفة المُراد ترتيبها
$array = array('a' => 4, 'b' => 8, 'c' => -1, 'd' => -9, 'e' => 2, 'f' => 5, 'g' => 3, 'h' => -4);
print_r($array);
// ترتيب وطباعة المصفوفة الناتجة
uasort($array, 'cmp');
print_r($array);
?>

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

Array
(
    [a] => 4
    [b] => 8
    [c] => -1
    [d] => -9
    [e] => 2
    [f] => 5
    [g] => 3
    [h] => -4
)
Array
(
    [d] => -9
    [h] => -4
    [c] => -1
    [e] => 2
    [g] => 3
    [a] => 4
    [f] => 5
    [b] => 8
)

انظر أيضًا

• usort()‎‎: ترتيب مصفوفة حسب القيم باستخدام دالة مقارنة معرفة من قبل المستخدم.
• مقارنة بين دوال ترتيب المصفوفة.

مصادر

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