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

(PHP 4, PHP 5, PHP 7)

تُرتّب الدالة natcasesort()‎‎‎‎‎ مصفوفة باستخدام خوارزمية "الترتيب الطبيعي" غير الحساسة لحالة الحرف.

الوصف

bool natcasesort ( array &$array )

الدالة natcasesort()‎‎‎‎‎ هي نسخة من الدالة ()‎natsort لكنها غير حساسة لحالة الحرف.

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

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

المعاملات

array

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

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

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

أمثلة

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

<?php
$array1 = $array2 = array('IMG0.png', 'img12.png', 'img10.png', 'img2.png', 'img1.png', 'IMG3.png');

sort($array1);
echo "Standard sorting\n";
print_r($array1);

natcasesort($array2);
echo "\nNatural order sorting (case-insensitive)\n";
print_r($array2);
?>

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

Standard sorting
Array
(
    [0] => IMG0.png
    [1] => IMG3.png
    [2] => img1.png
    [3] => img10.png
    [4] => img12.png
    [5] => img2.png
)

Natural order sorting (case-insensitive)
Array
(
    [0] => IMG0.png
    [4] => img1.png
    [3] => img2.png
    [5] => IMG3.png
    [2] => img10.png
    [1] => img12.png
)

لمزيد من المعلومات، راجع صفحة: "مقارنة سلسلة الترتيب الطبيعي" لمارتن بول (Martin Pool).

انظر أيضًا

• natsort()‎‎: ترتيب مصفوفة باستخدام خوارزمية "الترتيب الطبيعي".
• المقارنة بين دوال ترتيب المصفوفة.
• strnatcmp()‎‎: مقارنة السلسلة النصية باستخدام خوارزمية "الترتيب الطبيعي".
• strnatcasecmp()‎‎: مقارنة غير حساسة لحالة الحرف للسلسلة النصية باستخدام خوارزمية "الترتيب الطبيعي".

مصادر

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