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

(PHP 4, PHP 5, PHP 7)

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

الوصف

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

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

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

المعاملات

array

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

sort_flags

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

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

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

أمثلة

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

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

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

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

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

انظر أيضًا

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

مصادر

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