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

يعيد التابع 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: يجلب فهرس أول ظهور لعنصر محدَّد من مصفوفة أو فهرس أول عنصر يحقق شرطًا محدَّدًا.

مصادر

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