عرض مصدر Ruby/Enumerable/sort by

<noinclude>{{DISPLAYTITLE: التابع <code>Enumerable.sort_by</code> في روبي}}</noinclude>
يرتِّب التابع <code>sort_by</code> عناصر الكائن القابل للتعداد الذي استدعي معه باستعمال مجموعة من المفاتيح المولدة عبر تمرير قيم العناصر إلى الكتلة المعطاة.

لا يُضمَن بأن تكون النتيجة مستقرة. عندما تعيد عملية الموازنة بين مفتاحين القيمة 0، إذ لن يُتوقَع كيفية ترتيب هذين العنصرين ومن منهما سيسبق الآخر.

إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا جديدًا من النوع <code>[[Ruby/Enumerator|Enumerator]]</code>.

==البنية العامة==
<syntaxhighlight lang="ruby">sort_by { |obj| block } → array
sort_by → an_enumerator</syntaxhighlight>التنفيذ الحالي للتابع <code>sort_by</code> يولد مصفوفةً من الصفوف (tuples) تحوي مجموعة العناصر الأصلية والقيم المعيَّنة إلى كلٍّ منها. هذا يجعل تنفيذ التابع <code>sort_by</code> يستهلك كثيرًا من الموارد عندما تكون مجموعات المفاتيح بسيطة.<syntaxhighlight lang="ruby">
require 'benchmark'

a = (1..100000).map { rand(100000) }

Benchmark.bm(10) do |b|
  b.report("Sort")    { a.sort }
  b.report("Sort by") { a.sort_by { |a| a } }
end
</syntaxhighlight>ناتج تنفيذ الشيفرة هو:<syntaxhighlight lang="text">
user     system      total        real
Sort        0.180000   0.000000   0.180000 (  0.175469)
Sort by     1.980000   0.040000   2.020000 (  2.013586)
</syntaxhighlight>على أي حال، افترض أن موازنة المفاتيح هي عملية مهمة. ترتِّب الشيفرة التالية بعض الملفات بحسب وقت التعديل باستعمال التابع <code>sort</code> الأساسي:<syntaxhighlight lang="ruby">
files = Dir["*"]
sorted = files.sort { |a, b| File.new(a).mtime <=> File.new(b).mtime }
sorted   #=> ["mon", "tues", "wed", "thurs"]
</syntaxhighlight>للأسف، عملية الترتيب هذه غير ناجعة، إذ تولد كائنين جديدين من النوع <code>[[Ruby/File|File]]</code> أثناء إجراء كل عملة موازنة. هنالك تقنية أفضل بعض الشيء وهي استعمال التابع <code>[[Ruby/Kernel/test|Kernel.test]]</code> لتوليد أوقات التعديل مباشرة:<syntaxhighlight lang="ruby">
files = Dir["*"]
sorted = files.sort { |a, b|
  test(?M, a) <=> test(?M, b)
}
sorted   #=> ["mon", "tues", "wed", "thurs"]
</syntaxhighlight>هذا لا يزال يولد العديد من الكائنات <code>[[Ruby/Time|Time]]</code> غير الضرورية. هنالك طريقة أفضل وهي تخزين مفاتيح الترتيب (التي هي أوقات التعديل في حالتنا هذه) قبل إجراء عملية الترتيب. يسمي مستخدمو Perl غالبًا هذه الطريقة "تحويل شورتزيان" (Schwartzian transform) نسبةً إلى راندال شوارتز (Randal Schwartz). سننشئ أولًا مصفوفة مؤقتة، إذ يكون كل عنصر مصفوفةً - بحد ذاته - تحوي مفاتيح الترتيب جنبًا إلى جنب مع اسم الملف. سنرتب هذه المصفوفة ثم نستخرج اسم الملف منها بعدئذٍ:<syntaxhighlight lang="ruby">
sorted = Dir["*"].collect { |f|
   [test(?M, f), f]
}.sort.collect { |f| f[1] }
sorted   #=> ["mon", "tues", "wed", "thurs"]
</syntaxhighlight>هذا بالضبط ما يفعله التابع <code>sort_by</code> ضمنيًّا:<syntaxhighlight lang="ruby">
sorted = Dir["*"].sort_by { |f| test(?M, f) }
sorted   #=> ["mon", "tues", "wed", "thurs"]
</syntaxhighlight>

==القيمة المعادة==
تعاد [[Ruby/Array|مصفوفة]] جديد تحوي عناصر [[Ruby/Enumerable|الكائن القابل للترتيب]] المعطى بعد ترتيبها.
==أمثلة==
مثال على استعمال التابع <code>sort_by</code>:<syntaxhighlight lang="ruby">
%w{apple pear fig}.sort_by { |word| word.length }
              #=> ["fig", "pear", "apple"]
</syntaxhighlight>
==انظر أيضًا==
*التابع <code>[[Ruby/Enumerable/map|map]]</code>: يعيد مصفوفة جديدة تحوي النتائج المقابلة لكل عنصر من عناصر [[Ruby/Enumerator|الكائن القابل للتعداد]] المعادة من الكتلة المعطاة بعد تمريره إليها.

*التابع <code>[[Ruby/Enumerable/sort|sort]]</code>: يرتِّب عناصر [[Ruby/Enumerable|الكائن القابل للترتيب]] الذي استدعي معه ثم يعيدها في مصفوفة.
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Enumerable.html#method-i-sort_by قسم التابع sort_by في الصنف Enumerable في توثيق روبي الرسمي.]
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Enumerable]]