الفرق بين المراجعتين لصفحة: «Ruby/Array/drop»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>Array.drop</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method [[تصنيف: Ruby Array]...' |
لا ملخص تعديل |
||
| سطر 4: | سطر 4: | ||
[[تصنيف: Ruby Array]] | [[تصنيف: Ruby Array]] | ||
يحذف التابع <code>drop</code> أول <code>n</code> عنصر من مصفوفة ثمَّ يضع بقية العناصر في مصفوفة جديدة ويعيدها. | يحذف التابع <code>drop</code> أول <code>n</code> عنصر من مصفوفة ثمَّ يضع بقية العناصر في مصفوفة جديدة ويعيدها. | ||
إن مرِّر عددٌ سالبٌ إلى هذا التابع، فسيُطلَق الخطأ <code>ArgumentError</code>. | إن مرِّر عددٌ سالبٌ إلى هذا التابع، فسيُطلَق الخطأ <code>ArgumentError</code>. | ||
==البنية العامة== | ==البنية العامة== | ||
| سطر 10: | سطر 11: | ||
==المعاملات== | ==المعاملات== | ||
<code>n</code> | <code>n</code> | ||
عدد صحيح يحدد عدد العناصر الأولى المراد حذفها من المصفوفة. | عدد صحيح يحدد عدد العناصر الأولى المراد حذفها من المصفوفة. | ||
==القيم المعادة== | ==القيم المعادة== | ||
| سطر 21: | سطر 23: | ||
* التابع [[Ruby/Array/drop_while | <code>drop_while</code>]]: يحذف عناصر المصفوفة الأولى التي تحقِّق شرطًا محدَّدًا ثمَّ يعيد مصفوفة جديدة تحوي بقية العناصر. | * التابع [[Ruby/Array/drop_while | <code>drop_while</code>]]: يحذف عناصر المصفوفة الأولى التي تحقِّق شرطًا محدَّدًا ثمَّ يعيد مصفوفة جديدة تحوي بقية العناصر. | ||
* التابع [[Ruby/Array/delete_at | <code>delete_at</code>]]: يحذف عنصرًا ذا فهرس محدَّد من مصفوفة. | * التابع [[Ruby/Array/delete_at | <code>delete_at</code>]]: يحذف عنصرًا ذا فهرس محدَّد من مصفوفة. | ||
* التابع [[Ruby/Array/reject! | <code>reject | * التابع [[Ruby/Array/reject! | <code>reject</code>]]!: يحذف كل عنصر من عناصر المصفوفة والتي تُقيّم في الكتلة البرمجية المحددة بالقيمة <code>true</code>. إن لم يحدث أي تغيير فستعيد <code>nil</code>. | ||
* التابع [[Ruby/Array/compact | <code>compact</code>]]: يعيد نسخةً جديدة من المصفوفة التي استُدعي معها مع حذف كل العناصر التي تساوي <code>nil</code>. | * التابع [[Ruby/Array/compact | <code>compact</code>]]: يعيد نسخةً جديدة من المصفوفة التي استُدعي معها مع حذف كل العناصر التي تساوي <code>nil</code>. | ||
* التابع [[Ruby/Array/clear | <code>clear</code>]]: يزيل كل عناصر المصفوفة. | * التابع [[Ruby/Array/clear | <code>clear</code>]]: يزيل كل عناصر المصفوفة. | ||
* التابع [[Ruby/Array/push | <code>push</code>]]: يضيف جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه. | * التابع [[Ruby/Array/push | <code>push</code>]]: يضيف جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه. | ||
==مصادر== | ==مصادر== | ||
* قسم التابع drop في الصنف Array في توثيق روبي الرسمي. | * [https://ruby-doc.org/core-2.5.1/Array.html#method-i-drop قسم التابع drop في الصنف Array في توثيق روبي الرسمي.] | ||
مراجعة 11:12، 6 سبتمبر 2018
يحذف التابع drop أول n عنصر من مصفوفة ثمَّ يضع بقية العناصر في مصفوفة جديدة ويعيدها.
إن مرِّر عددٌ سالبٌ إلى هذا التابع، فسيُطلَق الخطأ ArgumentError.
البنية العامة
drop(n) → new_ary
المعاملات
n
عدد صحيح يحدد عدد العناصر الأولى المراد حذفها من المصفوفة.
القيم المعادة
تعاد مصفوفة جديدة تحوي جميع عناصر المصفوفة المعطاة باستثناء أول n عنصر منها.
أمثلة
مثالٌ على استخدام التابع drop:
a = [1, 2, 3, 4, 5, 0]
a.drop(3) #=> [4, 5, 0]
انظر أيضًا
- التابع
drop_while: يحذف عناصر المصفوفة الأولى التي تحقِّق شرطًا محدَّدًا ثمَّ يعيد مصفوفة جديدة تحوي بقية العناصر. - التابع
delete_at: يحذف عنصرًا ذا فهرس محدَّد من مصفوفة. - التابع
reject!: يحذف كل عنصر من عناصر المصفوفة والتي تُقيّم في الكتلة البرمجية المحددة بالقيمةtrue. إن لم يحدث أي تغيير فستعيدnil. - التابع
compact: يعيد نسخةً جديدة من المصفوفة التي استُدعي معها مع حذف كل العناصر التي تساويnil. - التابع
clear: يزيل كل عناصر المصفوفة. - التابع
push: يضيف جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه.