الفرق بين المراجعتين لصفحة: «Ruby/Array/min»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby Array]] | [[تصنيف: Ruby Array]] | ||
يعيد التابع <code>min</code> أصغر عنصر موجود في المصفوفة التي استُدعيت معه. يفترض الشكل الأول للتابع (تجده في القسم «البنية العامة») أنَّ كل الكائنات تقدم (implement) الصنف <code>[[Ruby/Comparable|Comparable]]</code>. أما الشكل الثاني، فيستخدم كتلة برمجية محددة للموازنة بين العناصر (يُجرَى ذلك باستعمال <code>a <= | يعيد التابع <code>min</code> أصغر عنصر موجود في المصفوفة التي استُدعيت معه. يفترض الشكل الأول للتابع (تجده في القسم «البنية العامة») أنَّ كل الكائنات تقدم (implement) الصنف <code>[[Ruby/Comparable|Comparable]]</code>. أما الشكل الثاني، فيستخدم كتلة برمجية محددة للموازنة بين العناصر (يُجرَى ذلك باستعمال <code>a <=> b</code>). | ||
إن مُرِّر الوسيط <code>n</code>، فسيعيد التابع مصفوفةً تحوي أصغر <code>n</code> عنصر موجود في المصفوفة الأصلية. | إن مُرِّر الوسيط <code>n</code>، فسيعيد التابع مصفوفةً تحوي أصغر <code>n</code> عنصر موجود في المصفوفة الأصلية. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby"> min → obj | <syntaxhighlight lang="ruby">min → obj | ||
min {| a,b | block } → obj | min {| a,b | block } → obj | ||
min(n) → array | min(n) → array | ||
| سطر 20: | سطر 20: | ||
==أمثلة== | ==أمثلة== | ||
مثال على استخدام التابع <code>min</code>: | مثال على استخدام التابع <code>min</code>: | ||
<syntaxhighlight lang="ruby"> ary = %w(albatross dog horse) | <syntaxhighlight lang="ruby">ary = %w(albatross dog horse) | ||
ary.min #=> "albatross" | ary.min #=> "albatross" | ||
ary.min { |a, b| a.length <=> b.length } #=> "dog" | ary.min { |a, b| a.length <=> b.length } #=> "dog" | ||
| سطر 30: | سطر 30: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* التابع [[Ruby/Array/max | <code>max</code>]]: يعيد أكبر عنصر موجود في المصفوفة التي استُدعيت معه. | * التابع<nowiki/>[[Ruby/Array/max | <code>max</code>]]: يعيد أكبر عنصر موجود في المصفوفة التي استُدعيت معه. | ||
* [[Ruby/Array/find_index | <code>find_index</code>]]: يجلب فهرس أول ظهور لعنصر محدَّد من مصفوفة أو فهرس أول عنصر يحقق شرطًا محدَّدًا. | * التابع<nowiki/>[[Ruby/Array/find_index | <code>find_index</code>]]: يجلب فهرس أول ظهور لعنصر محدَّد من مصفوفة أو فهرس أول عنصر يحقق شرطًا محدَّدًا. | ||
==مصادر== | ==مصادر== | ||
* [https://ruby-doc.org/core-2.5.1/Array.html#method-i-min قسم التابع min في الصنف Array في توثيق روبي الرسمي.] | * [https://ruby-doc.org/core-2.5.1/Array.html#method-i-min قسم التابع min في الصنف Array في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 07:56، 3 أكتوبر 2018
يعيد التابع 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: يجلب فهرس أول ظهور لعنصر محدَّد من مصفوفة أو فهرس أول عنصر يحقق شرطًا محدَّدًا.