Ruby/Array/drop

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

مصادر

• قسم التابع drop في الصنف Array في توثيق روبي الرسمي.