الفرق بين المراجعتين لصفحة: «Ruby/Array/sort by!»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
||
| سطر 7: | سطر 7: | ||
لن تكون النتيجة مضمونة مئة بالمئة، إذ لا يمكن التنبؤ بترتيب عنصري متجاورين لها نفس المفتاح. | لن تكون النتيجة مضمونة مئة بالمئة، إذ لا يمكن التنبؤ بترتيب عنصري متجاورين لها نفس المفتاح. | ||
في حال عدم تمرير كتلة برمجية إلى التابع<code>sort_by!</code>، سيعيد كائنًا من النوع <code>[[Ruby/Enumerator|Enumerator]]</code>. | في حال عدم تمرير كتلة برمجية إلى التابع <code>sort_by!</code>، سيعيد كائنًا من النوع <code>[[Ruby/Enumerator|Enumerator]]</code>. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby"> sort_by! { |obj| block } → ary | <syntaxhighlight lang="ruby">sort_by! { |obj| block } → ary | ||
sort_by! → Enumerator | sort_by! → Enumerator | ||
| سطر 18: | سطر 18: | ||
==أمثلة== | ==أمثلة== | ||
أمثلة على استخدام التابع <code>sort_by!</code>: | أمثلة على استخدام التابع <code>sort_by!</code>: | ||
<syntaxhighlight lang="ruby"> strings = %w(foo test blog a) | <syntaxhighlight lang="ruby">strings = %w(foo test blog a) | ||
strings.sort_by! { |str| str.length } | strings.sort_by! { |str| str.length } | ||
puts strings # ["a", "foo", "test", "blog"] | puts strings # ["a", "foo", "test", "blog"] | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* التابع [[Ruby/Array/sort! | <code>sort!</code>]]: يرتب عناصر المصفوفة التي استُدعيت معه. | * التابع<nowiki/>[[Ruby/Array/sort! | <code>sort!</code>]]: يرتب عناصر المصفوفة التي استُدعيت معه. | ||
* التابع [[Ruby/Array/shuffle! | <code>shuffle</code> | * التابع<nowiki/>[[Ruby/Array/shuffle! | <code>shuffle!</code>]]: يعيد ترتيب عناصر مصفوفة بشكل عشوائي. | ||
* التابع [[Ruby/Array/rotate | <code>rotate</code>]]: يعيد مصفوفة جديدة تحتوي عناصر المصفوفة التي استُدعيت معها مع إزاحة (تدوير) عناصرها ليكون العنصر ذو الفهرس الممرر إليها هو العنصر الأول في المصفوفة الجديدة. | * التابع<nowiki/>[[Ruby/Array/rotate | <code>rotate</code>]]: يعيد مصفوفة جديدة تحتوي عناصر المصفوفة التي استُدعيت معها مع إزاحة (تدوير) عناصرها ليكون العنصر ذو الفهرس الممرر إليها هو العنصر الأول في المصفوفة الجديدة. | ||
* التابع [[Ruby/Array/reverse! | <code>reverse!</code>]]: يعكس ترتيب عناصر المصفوفة التي استُدعيت معه. | * التابع<nowiki/>[[Ruby/Array/reverse! | <code>reverse!</code>]]: يعكس ترتيب عناصر المصفوفة التي استُدعيت معه. | ||
==مصادر== | ==مصادر== | ||
* [https://ruby-doc.org/core-2.5.1/Array.html#method-i-sort_by-21 قسم التابع sort_by! في الصنف Array في توثيق روبي الرسمي.] | * [https://ruby-doc.org/core-2.5.1/Array.html#method-i-sort_by-21 قسم التابع sort_by! في الصنف Array في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 10:07، 3 أكتوبر 2018
يُرتِّب التابع sort_by! المصفوفة التي استُدعيت معه وفقًا لمجموعة من المفاتيح (set of keys) المولدة عبر تمرير كل عنصر من عناصر المصفوفة إلى كتلة برمجية مُحددة.
لن تكون النتيجة مضمونة مئة بالمئة، إذ لا يمكن التنبؤ بترتيب عنصري متجاورين لها نفس المفتاح.
في حال عدم تمرير كتلة برمجية إلى التابع sort_by!، سيعيد كائنًا من النوع Enumerator.
البنية العامة
sort_by! { |obj| block } → ary
sort_by! → Enumerator
القيم المعادة
تعاد المصفوفة نفسها المعطاة بعد ترتيب عناصرها وفقًا للقيمة التي تعيدها الكتلة block لكل عنصر عند استدعائها معه، أو يعاد كائن من النوع Enumerator إن لم تعطَ الكتلة block.
أمثلة
أمثلة على استخدام التابع sort_by!:
strings = %w(foo test blog a)
strings.sort_by! { |str| str.length }
puts strings # ["a", "foo", "test", "blog"]
انظر أيضًا
- التابع
sort!: يرتب عناصر المصفوفة التي استُدعيت معه. - التابع
shuffle!: يعيد ترتيب عناصر مصفوفة بشكل عشوائي. - التابع
rotate: يعيد مصفوفة جديدة تحتوي عناصر المصفوفة التي استُدعيت معها مع إزاحة (تدوير) عناصرها ليكون العنصر ذو الفهرس الممرر إليها هو العنصر الأول في المصفوفة الجديدة. - التابع
reverse!: يعكس ترتيب عناصر المصفوفة التي استُدعيت معه.