التابع Array.shift في روبي
يحذف التابع shift أول عنصر أو أول n عنصر من عناصر مصفوفة ثم يعيده أو يعيد مصفوفة تحوي العناصر المحذوفة.
إن مرِّر عدد n كوسيط إلى التابع shift، فسيحذف أول n عنصر من المصفوفة ثمَّ يعيدها في مصفوفة جديدة وهذا مشابه تمامًا لاستدعاء التابع slice! بالشكل: array.slice!(0, n). ستحتوي المصفوفة الأصلية حينئذٍ العناصر المتبقية فقط دون العناصر التي أزيحت ووُضعت في المصفوفة الجديدة المُعادة.
البنية العامة
shift → obj or nil
shift(n) → new_ary
المعاملات
n
عدد صحيح يمثل عدد العناصر الأولى المراد حذفها من المصفوفة المعطاة.
القيم المعادة
يعاد العنصر الأول المحذوف من المصفوفة المعطاة، أو تعاد مصفوفة جديدة تحوي العناصر n الأولى المحذوفة من المصفوفة، أو تعاد القيمة nil إن كانت المصفوفة فارغة.
أمثلة
أمثلة على استخدام التابع shift:
args = [ "-m", "-q", "filename" ]
args.shift #=> "-m"
args #=> ["-q", "filename"]
args = [ "-m", "-q", "filename" ]
args.shift(2) #=> ["-m", "-q"]
args #=> ["filename"]
انظر أيضًا
- التابع
unshift: يضيف الكائنات المُمرَّرة إليه إلى بداية المصفوفة التي استُدعيت معه مع إزاحة العناصر الأخرى إلى الأمام. - التابع
pop: يحذف آخر عنصر أو آخرnعنصر من مصفوفة ثم يعيده أو يعيدها في مصفوفة جديدة. - التابع
drop: يحذف التابعdropأولnعنصر من المصفوفة ويعيد بقية العناصر في مصفوفة جديدة. - التابع
delete_at: يحذف التابعdelete_atالعنصر من المصفوفة الموجود عند الفهرس المحددindex. ويعيد ذلك العنصر أو القيمةnilإن كان الفهرس خارج نطاق المصفوفة. - التابع
rotate: يعيد مصفوفة جديدة تحتوي عناصر المصفوفة التي استُدعيت معها مع إزاحة (تدوير) عناصرها ليكون العنصر ذو الفهرس الممرر إليها هو العنصر الأول في المصفوفة الجديدة.