الفرق بين المراجعتين لصفحة: «Ruby/Array/flatten»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>Array.flatten</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method تصنيف: Ruby Arr...' |
لا ملخص تعديل |
||
| سطر 4: | سطر 4: | ||
[[تصنيف: Ruby Array]] | [[تصنيف: Ruby Array]] | ||
يجعل التابع <code>flatten</code> المصفوفة التي تحوي عناصر متشعبة ضمنها مصفوفةً أحادية البعد بشكل تعاودي (<code>recursively</code>)؛ أي أنَّ كل عنصر من عناصر المصفوفة المعطاة والذي قد يكون نفسه مصفوفةً متشعبةً من مستوًى واحدٍ أو أكثر ستُستخلَص عناصره وتضاف إلى مصفوفة جديدة. | يجعل التابع <code>flatten</code> المصفوفة التي تحوي عناصر متشعبة ضمنها مصفوفةً أحادية البعد بشكل تعاودي (<code>recursively</code>)؛ أي أنَّ كل عنصر من عناصر المصفوفة المعطاة والذي قد يكون نفسه مصفوفةً متشعبةً من مستوًى واحدٍ أو أكثر ستُستخلَص عناصره وتضاف إلى مصفوفة جديدة. | ||
يقبل هذا التابع تمرير المعامل <code>level</code> الاختياري الذي يحدد مستوى التعاودية ( | |||
يقبل هذا التابع تمرير المعامل <code>level</code> الاختياري الذي يحدد مستوى التعاودية (recursion level). | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby"> flatten → new_ary | <syntaxhighlight lang="ruby"> flatten → new_ary | ||
| سطر 10: | سطر 11: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==المعاملات== | ==المعاملات== | ||
<code>level</code> | |||
=== <code>level</code> === | |||
عدد صحيح يحدد مستوى التشعُّب التي يراد استخلاص العناصر الواقعة فيه وجعلها أحادية. | عدد صحيح يحدد مستوى التشعُّب التي يراد استخلاص العناصر الواقعة فيه وجعلها أحادية. | ||
==القيم المعادة== | ==القيم المعادة== | ||
| سطر 24: | سطر 26: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* التابع [[Ruby/Array/flatten! | <code>flatten | * التابع [[Ruby/Array/flatten! | <code>flatten</code>]]!: يشبه التابع <code>flatten</code> في جميع النواحي باستثناء أنه لا يضع الناتج في مصفوفة جديدة وإنما يعدل على المصفوفة الأصلية نفسها. | ||
* التابع [[Ruby/Array/dig | <code>dig</code>]]: يستخرج العنصر المتشعِّب ( | * التابع [[Ruby/Array/dig | <code>dig</code>]]: يستخرج العنصر المتشعِّب (nested value) المحدَّد بسلسلة الوسائط <code>idx</code> الممرَّرة إليه وذلك عبر استدعاء [[Ruby/Array/dig | <code>dig</code>]] عند كل مستوى تشعب. | ||
==مصادر== | ==مصادر== | ||
* قسم التابع flatten في الصنف Array في توثيق روبي الرسمي. | * [https://ruby-doc.org/core-2.5.1/Array.html#method-i-flatten قسم التابع flatten في الصنف Array في توثيق روبي الرسمي.] | ||
مراجعة 17:21، 6 سبتمبر 2018
يجعل التابع flatten المصفوفة التي تحوي عناصر متشعبة ضمنها مصفوفةً أحادية البعد بشكل تعاودي (recursively)؛ أي أنَّ كل عنصر من عناصر المصفوفة المعطاة والذي قد يكون نفسه مصفوفةً متشعبةً من مستوًى واحدٍ أو أكثر ستُستخلَص عناصره وتضاف إلى مصفوفة جديدة.
يقبل هذا التابع تمرير المعامل level الاختياري الذي يحدد مستوى التعاودية (recursion level).
البنية العامة
flatten → new_ary
flatten(level) → new_ary
المعاملات
level
عدد صحيح يحدد مستوى التشعُّب التي يراد استخلاص العناصر الواقعة فيه وجعلها أحادية.
القيم المعادة
تعاد مصفوفة جديدة أحادية البعد تحوي جميع عناصر المصفوفة المعطاة بعد استخراج العناصر المتشعبة منها مهما كان مستوى تشعبها أو بحسب مستوى التشعب level (إن أعطي).
أمثلة
أمثلة على استخدام التابع flatten:
s = [ 1, 2, 3 ] #=> [1, 2, 3]
t = [ 4, 5, 6, [7, 8] ] #=> [4, 5, 6, [7, 8]]
a = [ s, t, 9, 10 ] #=> [[1, 2, 3], [4, 5, 6, [7, 8]], 9, 10]
a.flatten #=> [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
a = [ 1, 2, [3, [4, 5] ] ]
a.flatten(1) #=> [1, 2, 3, [4, 5]]
انظر أيضًا
- التابع
flatten!: يشبه التابعflattenفي جميع النواحي باستثناء أنه لا يضع الناتج في مصفوفة جديدة وإنما يعدل على المصفوفة الأصلية نفسها. - التابع
dig: يستخرج العنصر المتشعِّب (nested value) المحدَّد بسلسلة الوسائطidxالممرَّرة إليه وذلك عبر استدعاءdigعند كل مستوى تشعب.