عرض مصدر PHP/natcasesort

<noinclude>{{DISPLAYTITLE:الدالة <code>natcasesort()</code>‎‎‎‎‎ في PHP}}</noinclude>
(PHP 4, PHP 5, PHP 7)

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

== الوصف ==
<syntaxhighlight lang="php">
bool natcasesort ( array &$array )
</syntaxhighlight>الدالة <code>natcasesort()‎‎‎‎‎</code> هي نسخة من الدالة <code>[[PHP/natsort|()‎natsort]]</code> لكنها غير حساسة لحالة الحرف.

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

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

== المعاملات ==

=== <code>array</code> ===
المصفوفة المُدخَلة.

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

== أمثلة ==
المثال 1: مثال على الدالة <code>natcasesort()‎‎‎‎‎</code><syntaxhighlight lang="php">
<?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);
?>
</syntaxhighlight>سوف تكون مُخرجات المثال أعلاه كالتالي:<syntaxhighlight lang="php">
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
)
</syntaxhighlight>لمزيد من المعلومات، راجع صفحة: "[http://sourcefrog.net/projects/natsort/ مقارنة سلسلة الترتيب الطبيعي]" لمارتن بول (Martin Pool).

== انظر أيضًا ==
* <code>[[PHP/natsort|natsort()‎‎]]</code>: ترتيب مصفوفة باستخدام خوارزمية "الترتيب الطبيعي".
* [[PHP/Array Sorting|المقارنة بين دوال ترتيب المصفوفة]].
* <code>[[PHP/strnatcmp|strnatcmp()‎‎]]</code>: مقارنة السلسلة النصية باستخدام خوارزمية "الترتيب الطبيعي".
* <code>[[PHP/strnatcasecmp|strnatcasecmp()‎‎]]</code>: مقارنة غير حساسة لحالة الحرف للسلسلة النصية باستخدام خوارزمية "الترتيب الطبيعي".

== مصادر ==
* [http://php.net/manual/en/function.natcasesort.php صفحة الدالة natcasesort في توثيق PHP الرسمي].
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Array]]