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