التابع Array.slice!‎ في روبي

يقتطع التابع slice!!‎ عنصرًا ذي فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من المصفوفة التي استدعيت معه. يعيد التابع slice!!‎ العناصر المحذوفة، أو nil إن كان index خارج النطاق.

البنية العامة

 slice!(index) → obj or nil
slice!(start, length) → new_ary or nil
slice!(range) → new_ary or nil

المعاملات

index عدد صحيح يمثل فهرس العنصر المراد اقتطاعه من المصفوفة المعطاة. start عدد صحيح يمثل فهرس البداية للعناصر المراد اقتطاعها من المصفوفة المعطاة. length عدد صحيح يمثل طول العناصر المراد اقتطاعها من المصفوفة المعطاة. range مجال يحدد فهرس البداية وفهرس النهاية لمجال العناصر المراد اقتطاعها من المصفوفة المعطاة.

القيم المعادة

يعاد العنصر ذو الفهرس index الذي اقتُطِع (حُذِف) من المصفوفة المعطاة، أو تعاد مصفوفة جديدة تحوي العناصر المحددة بعنصر البداية ذي الفهرس start وبطول length أو المحددة بالمجال range المراد اقتطاعها، أو تعاد القيمة nil إن كان إن كان الفهرس index أو فهرس البداية start يقع خارج نطاق المصفوفة.

أمثلة

بعض الأمثلة لاستخدام التابع slice!!‎:

 a = [ "a", "b", "c" ]
a.slice!(1)     #=> "b"
a               #=> ["a", "c"]
a.slice!(-1)    #=> "c"
a               #=> ["a"]
a.slice!(100)   #=> nil
a               #=> ["a"]

انظر أيضًا

• التابع slice: يجلب عنصرًا ذي فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من مصفوفة.
• التابع at: يجلب عنصرًا ذي فهرس محدد من المصفوفة المستدعاة معه.
• التابع fetch: يجلب عنصرًا ذي فهرس محدَّد من مصفوفة.
• التابع select: يحدد جميع عناصر المصفوفة المحققة لشرط معين ويضعها في مصفوفة جديدة.
• معامل الفهرسة []: يجلب عنصرًا ذي فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من مصفوفة.

مصادر

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