عرض مصدر Ruby/Array/slice!

<noinclude>{{DISPLAYTITLE: التابع <code>Array.slice!‎</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Array]]
يقتطع التابع <code>slice!‎</code> عنصرًا ذي فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من المصفوفة التي استدعيت معه. 

يعيد التابع <code>slice!‎</code> العناصر المحذوفة، أو <code>nil</code> إن كان <code>index</code> خارج النطاق.
==البنية العامة==
<syntaxhighlight lang="ruby">slice!(index) → obj or nil
slice!(start, length) → new_ary or nil
slice!(range) → new_ary or nil
 </syntaxhighlight>
==المعاملات==

=== <code>index</code> ===
عدد صحيح يمثل فهرس العنصر المراد اقتطاعه من المصفوفة المعطاة.

=== <code>start</code> ===
عدد صحيح يمثل فهرس البداية للعناصر المراد اقتطاعها من المصفوفة المعطاة.

=== <code>length</code> ===
عدد صحيح يمثل طول العناصر المراد اقتطاعها من المصفوفة المعطاة.

=== <code>range</code> ===
مجال يحدد فهرس البداية وفهرس النهاية لمجال العناصر المراد اقتطاعها من المصفوفة المعطاة.
==القيم المعادة==
يعاد العنصر ذو الفهرس <code>index</code> الذي اقتُطِع (حُذِف) من المصفوفة المعطاة، أو تعاد مصفوفة جديدة تحوي العناصر المحددة بعنصر البداية ذي الفهرس <code>start</code> وبطول <code>length</code> أو المحددة بالمجال <code>range</code> المراد اقتطاعها، أو تعاد القيمة <code>nil</code> إن كان إن كان الفهرس <code>index</code> أو فهرس البداية <code>start</code> يقع خارج نطاق المصفوفة.
==أمثلة==
بعض الأمثلة لاستخدام  التابع <code>slice!‎</code>:
<syntaxhighlight lang="ruby">a = [ "a", "b", "c" ]
a.slice!(1)     #=> "b"
a               #=> ["a", "c"]
a.slice!(-1)    #=> "c"
a               #=> ["a"]
a.slice!(100)   #=> nil
a               #=> ["a"]
 </syntaxhighlight>
==انظر أيضًا==
* التابع<nowiki/>[[Ruby/Array/slice | <code>slice</code>]]: يجلب عنصرًا ذي فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من مصفوفة.
* التابع<nowiki/>[[Ruby/Array/at | <code>at</code>]]: يجلب عنصرًا ذي فهرس محدد من المصفوفة المستدعاة معه.
* التابع<nowiki/>[[Ruby/Array/fetch | <code>fetch</code>]]: يجلب عنصرًا ذي فهرس محدَّد من مصفوفة.
* التابع<nowiki/>[[Ruby/Array/select | <code>select</code>]]: يحدد جميع عناصر المصفوفة المحققة لشرط معين ويضعها في مصفوفة جديدة.
* معامل الفهرسة <code>[[Ruby/Array/index operator|[]]]</code>: يجلب عنصرًا ذي فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من مصفوفة.
==مصادر==
* [https://ruby-doc.org/core-2.5.1/Array.html#method-i-slice-21 قسم التابع slice!‎ في الصنف Array في توثيق روبي الرسمي.]