التابع Array.max في روبي

يعيد التابع max أكبر عنصر موجود في المصفوفة التي استُدعيت معه. يفترض الشكل الأول للتابع (تجده في القسم «البنية العامة») أنَّ كل الكائنات تقدم (implement) الصنف Comparable. أمَّا الشكل الثاني، فيستخدم كتلة برمجية محددة للموازنة بين العناصر (يُجرَى ذلك باستعمال a <=> b). إن مرِّر الوسيط n، فسيعيد التابع مصفوفة تحوي أكبر n عنصر موجود في المصفوفة الأصلية.

البنية العامة

 max → obj
max { |a, b| block } → obj
max(n) → array
max(n) { |a, b| block } → array

المعاملات

n عدد صحيح يحدد عدد العناصر الأعظمية الموجودة في المصفوفة المعطاة والمراد جلبها.

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

يعاد أكبر عنصر موجود في المصفوفة المعطاة، أو تعاد مصفوفةٌ جديدة تحوي أكبر n عنصر.

أمثلة

مثالٌ على استخدام التابع max:

 ary = %w(albatross dog horse)
ary.max                                   #=> "horse"
ary.max { |a, b| a.length <=> b.length }  #=> "albatross"
مثالٌ على استخدام التابع max مع الوسيط n:
ary = %w[albatross dog horse]
ary.max(2)                                  #=> ["horse", "dog"]
ary.max(2) {|a, b| a.length <=> b.length }  #=> ["albatross", "horse"]

انظر أيضًا

• التابع min: يعيد أصغر عنصر موجود في المصفوفة التي استُدعيت معه.
• find_index: يجلب فهرس أول ظهور لعنصر محدَّد من مصفوفة أو فهرس أول عنصر يحقق شرطًا محدَّدًا.

مصادر

• قسم التابع max في الصنف Array في توثيق روبي الرسمي.