التابع Array.drop في روبي

من موسوعة حسوب
< Ruby‏ | Array

يحذف التابع 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: يضيف جميع الكائنات المُمرّرة إليه إلى نهاية المصفوفة التي استُدعيت معه.

مصادر