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