الفرق بين المراجعتين لصفحة: «Ruby/Array/take while»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>Array.take_while</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method تصنيف: Ruby...' |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
||
| (مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة) | |||
| سطر 4: | سطر 4: | ||
[[تصنيف: Ruby Array]] | [[تصنيف: Ruby Array]] | ||
يجلب التابع <code>take_while</code> العناصر الأولى من مصفوفة التي تحقق شرطًا معينًا؛ أي يستمر التابع في جلب العناصر الأولى ما دامت محققة للشرط ويتوقف عندما لا يحقق أحد العناصر ذلك الشرط المعطى. | يجلب التابع <code>take_while</code> العناصر الأولى من مصفوفة التي تحقق شرطًا معينًا؛ أي يستمر التابع في جلب العناصر الأولى ما دامت محققة للشرط ويتوقف عندما لا يحقق أحد العناصر ذلك الشرط المعطى. | ||
إن لم تمرَّر أية كتلة إلى التابع <code>take_while</code>، فسيعيد كائنًا من النوع <code>Enumerator</code>. | |||
إن لم تمرَّر أية كتلة إلى التابع <code>take_while</code>، فسيعيد كائنًا من النوع <code>[[Ruby/Enumerator|Enumerator]]</code>. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby"> take_while { |obj| block } → new_ary | <syntaxhighlight lang="ruby">take_while { |obj| block } → new_ary | ||
take_while → Enumerator | take_while → Enumerator | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==القيم المعادة== | ==القيم المعادة== | ||
تعاد مصفوفة جديدة تحوي العناصر الأولى التي تعاد معها القيمة <code>true</code> عند تطبيق الكتلة <code>block</code> عليها إلى أن تعاد القيمة <code>false</code> أو القيمة <code>nil</code> مع أحد العناصر، أو يعاد كائن من النوع <code>Enumerator</code> إن لم تعطَ الكتلة <code>block</code>. | تعاد مصفوفة جديدة تحوي العناصر الأولى التي تعاد معها القيمة <code>true</code> عند تطبيق الكتلة <code>block</code> عليها إلى أن تعاد القيمة <code>false</code> أو القيمة <code>nil</code> مع أحد العناصر، أو يعاد كائن من النوع <code>[[Ruby/Enumerator|Enumerator]]</code> إن لم تعطَ الكتلة <code>block</code>. | ||
==أمثلة== | ==أمثلة== | ||
مثالٌ على استخدام التابع <code>take_while</code>: | مثالٌ على استخدام التابع <code>take_while</code>: | ||
<syntaxhighlight lang="ruby"> a = [1, 2, 3, 4, 5, 0] | <syntaxhighlight lang="ruby">a = [1, 2, 3, 4, 5, 0] | ||
a.take_while { |i| i < 3 } #=> [1, 2] | a.take_while { |i| i < 3 } #=> [1, 2] | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* التابع [[Ruby/Array/take | <code>take</code>]]: يجلب أول <code>n</code> عنصر من مصفوفة. | * التابع<nowiki/>[[Ruby/Array/take | <code>take</code>]]: يجلب أول <code>n</code> عنصر من مصفوفة. | ||
* التابع [[Ruby/Array/drop_while | <code>drop_while</code>]]: يحذف عناصر المصفوفة الأولى التي تحقِّق شرطًا محدَّدًا ثمَّ يعيد مصفوفة جديدة تحوي بقية العناصر. | * التابع<nowiki/>[[Ruby/Array/drop_while | <code>drop_while</code>]]: يحذف عناصر المصفوفة الأولى التي تحقِّق شرطًا محدَّدًا ثمَّ يعيد مصفوفة جديدة تحوي بقية العناصر. | ||
==مصادر== | ==مصادر== | ||
* قسم التابع take_while في الصنف Array في توثيق روبي الرسمي. | * [https://ruby-doc.org/core-2.5.1/Array.html#method-i-take_while قسم التابع take_while في الصنف Array في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 10:13، 3 أكتوبر 2018
يجلب التابع take_while العناصر الأولى من مصفوفة التي تحقق شرطًا معينًا؛ أي يستمر التابع في جلب العناصر الأولى ما دامت محققة للشرط ويتوقف عندما لا يحقق أحد العناصر ذلك الشرط المعطى.
إن لم تمرَّر أية كتلة إلى التابع take_while، فسيعيد كائنًا من النوع Enumerator.
البنية العامة
take_while { |obj| block } → new_ary
take_while → Enumerator
القيم المعادة
تعاد مصفوفة جديدة تحوي العناصر الأولى التي تعاد معها القيمة true عند تطبيق الكتلة block عليها إلى أن تعاد القيمة false أو القيمة nil مع أحد العناصر، أو يعاد كائن من النوع Enumerator إن لم تعطَ الكتلة block.
أمثلة
مثالٌ على استخدام التابع take_while:
a = [1, 2, 3, 4, 5, 0]
a.take_while { |i| i < 3 } #=> [1, 2]
انظر أيضًا
- التابع
take: يجلب أولnعنصر من مصفوفة. - التابع
drop_while: يحذف عناصر المصفوفة الأولى التي تحقِّق شرطًا محدَّدًا ثمَّ يعيد مصفوفة جديدة تحوي بقية العناصر.