الفرق بين المراجعتين لصفحة: «PHP/asort»
< PHP
ط تعديل عنوان الصفحة |
ط تصحيح العناوين |
||
| سطر 4: | سطر 4: | ||
تُرتِّب الدالة <code>asort()</code> عناصر المصفوفة وتحافظ على اقتران الفهارس مع القيم المرتبطة بها. | تُرتِّب الدالة <code>asort()</code> عناصر المصفوفة وتحافظ على اقتران الفهارس مع القيم المرتبطة بها. | ||
= الوصف = | == الوصف == | ||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
bool asort ( array &$array [, int $sort_flags = SORT_REGULAR ] ) | bool asort ( array &$array [, int $sort_flags = SORT_REGULAR ] ) | ||
| سطر 13: | سطر 13: | ||
ملاحظة: إذا تساوت مقارنة عنصرين، فإن ترتيبهما النسبي في المصفوفة المُرتّبة يكون غير محدد. | ملاحظة: إذا تساوت مقارنة عنصرين، فإن ترتيبهما النسبي في المصفوفة المُرتّبة يكون غير محدد. | ||
= المعاملات = | == المعاملات == | ||
=== <code>array</code> === | === <code>array</code> === | ||
| سطر 21: | سطر 21: | ||
يمكن تعديل طريقة الترتيب باستخدام المعامل الاختياري <code>sort_flags</code>، لمزيد من التفاصيل، راجع الدالة <code>[[PHP/Function/sort|sort()]]</code>. | يمكن تعديل طريقة الترتيب باستخدام المعامل الاختياري <code>sort_flags</code>، لمزيد من التفاصيل، راجع الدالة <code>[[PHP/Function/sort|sort()]]</code>. | ||
= القيم المعادة = | == القيم المعادة == | ||
تُعيد الدالة القيمة <code>TRUE</code> عند نجاح عملها أو <code>FALSE</code> عند فشل تنفيذها. | تُعيد الدالة القيمة <code>TRUE</code> عند نجاح عملها أو <code>FALSE</code> عند فشل تنفيذها. | ||
= أمثلة = | == أمثلة == | ||
المثال 1: مثال على الدالة <code>asort()</code><syntaxhighlight lang="php"> | المثال 1: مثال على الدالة <code>asort()</code><syntaxhighlight lang="php"> | ||
<?php | <?php | ||
| سطر 40: | سطر 40: | ||
</syntaxhighlight>رُتِبت المصفوفة fruits بالترتيب الهجائي وحُوفِظ على الفهرس المقترن بكل عنصر. | </syntaxhighlight>رُتِبت المصفوفة fruits بالترتيب الهجائي وحُوفِظ على الفهرس المقترن بكل عنصر. | ||
= انظر أيضًا = | == انظر أيضًا == | ||
* الدالة <code>[[PHP/Function/arsort|arsort()]]</code>: ترتيب عناصر المصفوفة بترتيب عكسي والحفاظ على اقتران الفهارس مع القيم المرتبطة بها. | * الدالة <code>[[PHP/Function/arsort|arsort()]]</code>: ترتيب عناصر المصفوفة بترتيب عكسي والحفاظ على اقتران الفهارس مع القيم المرتبطة بها. | ||
* [[PHP/Array Sorting|مقارنة بين دوال ترتيب المصفوفة]]. | * [[PHP/Array Sorting|مقارنة بين دوال ترتيب المصفوفة]]. | ||
= مصادر = | == مصادر == | ||
* [http://php.net/manual/en/function.asort.php صفحة الدالة asort في توثيق PHP الرسمي]. | * [http://php.net/manual/en/function.asort.php صفحة الدالة asort في توثيق PHP الرسمي]. | ||
مراجعة 03:37، 28 مارس 2018
(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(): ترتيب عناصر المصفوفة بترتيب عكسي والحفاظ على اقتران الفهارس مع القيم المرتبطة بها. - مقارنة بين دوال ترتيب المصفوفة.