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

من موسوعة حسوب
< Ruby‏ | Array

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

إن مُرِّر الوسيط n، فسيعيد التابع مصفوفةً تحوي أصغر n عنصر موجود في المصفوفة الأصلية.

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

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

المعاملات

n

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

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

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

أمثلة

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

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

انظر أيضًا

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

مصادر