عرض مصدر Ruby/Array/shift

<noinclude>{{DISPLAYTITLE: التابع <code>Array.shift</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Array]]
يحذف التابع <code>shift</code> أول عنصر أو أول <code>n</code> عنصر من عناصر مصفوفة ثم يعيده أو يعيد مصفوفة تحوي العناصر المحذوفة.
إن مرِّر عدد <code>n</code> كوسيط إلى التابع <code>shift</code>، فسيحذف أول <code>n</code> عنصر من المصفوفة ثمَّ يعيدها في مصفوفة جديدة وهذا مشابه تمامًا لاستدعاء التابع !<code>!slice</code> بالشكل <code>array</code>.[[Ruby/Array/slice! | <code>slice!</code>]]!(0, <code>n</code>)‎. ستحتوي المصفوفة الأصلية حينئذٍ العناصر المتبقية فقط دون العناصر التي أزيحت ووُضعت في المصفوفة الجديدة المُعادة.
==البنية العامة==
<syntaxhighlight lang="ruby"> shift → obj or nil
shift(n) → new_ary
 </syntaxhighlight>
==المعاملات==
<code>n</code>
عدد صحيح يمثل عدد العناصر الأولى المراد حذفها من المصفوفة المعطاة.
==القيم المعادة==
يعاد العنصر الأول المحذوف من المصفوفة المعطاة، أو تعاد مصفوفة جديدة تحوي العناصر <code>n</code> الأولى المحذوفة من المصفوفة، أو تعاد القيمة <code>nil</code> إن كانت المصفوفة فارغة.
==أمثلة==
أمثلة على استخدام التابع <code>shift</code>:
<syntaxhighlight lang="ruby"> args = [ "-m", "-q", "filename" ]
args.shift     #=> "-m"
args           #=> ["-q", "filename"]

args = [ "-m", "-q", "filename" ]
args.shift(2)  #=> ["-m", "-q"]
args           #=> ["filename"]
 </syntaxhighlight>
==انظر أيضًا==
* التابع [[Ruby/Array/unshift | <code>unshift</code>]]: يضيف الكائنات المُمرَّرة إليه إلى بداية المصفوفة التي استُدعيت معه مع إزاحة العناصر الأخرى إلى الأمام.
* التابع [[Ruby/Array/pop | <code>pop</code>]]: يحذف آخر عنصر أو آخر <code>n</code> عنصر من مصفوفة ثم يعيده أو يعيدها في مصفوفة جديدة.
* التابع [[Ruby/Array/drop | <code>drop</code>]]: يحذف التابع [[Ruby/Array/drop | <code>drop</code>]] أول <code>n</code> عنصر من المصفوفة ويعيد بقية العناصر في مصفوفة جديدة.
* التابع [[Ruby/Array/delete_at | <code>delete_at</code>]]: يحذف التابع [[Ruby/Array/delete_at | <code>delete_at</code>]] العنصر من المصفوفة الموجود عند الفهرس المحدد [[Ruby/Array/index | <code>index</code>]]. ويعيد ذلك العنصر أو القيمة <code>nil</code> إن كان الفهرس خارج نطاق المصفوفة.
* التابع [[Ruby/Array/rotate | <code>rotate</code>]]: يعيد مصفوفة جديدة تحتوي عناصر المصفوفة التي استُدعيت معها مع إزاحة (تدوير) عناصرها ليكون العنصر ذو الفهرس الممرر إليها هو العنصر الأول في المصفوفة الجديدة.
==مصادر==
* قسم التابع shift في الصنف Array في توثيق روبي الرسمي.