الفرق بين المراجعتين لصفحة: «Ruby/Array/each index»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
||
| سطر 5: | سطر 5: | ||
يستدعي التابع <code>each_index</code> كتلة برمجية محددة مع فهرس كل عنصر من عناصر مصفوفة، إذ يُمرَّر ذلك الفهرس كوسيط إلى الكتلة ثم يعيد المصفوفة نفسها. | يستدعي التابع <code>each_index</code> كتلة برمجية محددة مع فهرس كل عنصر من عناصر مصفوفة، إذ يُمرَّر ذلك الفهرس كوسيط إلى الكتلة ثم يعيد المصفوفة نفسها. | ||
إن لم تمرَّر أيَّة كتلة إلى التابع <code>each_index</code>، فسيُعيد كائنًا من النوع <code>[[Ruby | إن لم تمرَّر أيَّة كتلة إلى التابع <code>each_index</code>، فسيُعيد كائنًا من النوع <code>[[Ruby/Enumerator|Enumerator]]</code>. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby"> each_index { |index| block } → ary | <syntaxhighlight lang="ruby"> each_index { |index| block } → ary | ||
| سطر 11: | سطر 11: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==القيم المعادة== | ==القيم المعادة== | ||
تعاد المصفوفة نفسها المعطاة بعد تطبيق الكتلة <code>block</code> على فهرس كل عنصر من عناصرها، أو يعاد كائنٌ من النوع <code>[[Ruby/Array/Enumerator|Enumerator]]</code> إن لم تعطَ الكتلة <code>block</code>. | تعاد المصفوفة نفسها المعطاة بعد تطبيق الكتلة <code>block</code> على فهرس كل عنصر من عناصرها، أو يعاد كائنٌ من النوع [[Ruby/Enumerator|<code></code>]]<code>[[Ruby/Array/Enumerator|Enumerator]]</code> إن لم تعطَ الكتلة <code>block</code>. | ||
==أمثلة== | ==أمثلة== | ||
مثالٌ على استخدام التابع <code>each_index</code>: | مثالٌ على استخدام التابع <code>each_index</code>: | ||
| سطر 20: | سطر 20: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* التابع [[Ruby/Array/each | <code>each</code>]]: يستدعي كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة، إذ تمرَّر قيمة ذلك العنصر كوسيط إلى الكتلة ثمَّ يعيد المصفوفة نفسها المعطاة. | * التابع<nowiki/>[[Ruby/Array/each | <code>each</code>]]: يستدعي كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة، إذ تمرَّر قيمة ذلك العنصر كوسيط إلى الكتلة ثمَّ يعيد المصفوفة نفسها المعطاة. | ||
* التابع [[Ruby/Array/find_index | <code>find_index</code>]]: يجلب فهرس أول ظهور لعنصر محدَّد من مصفوفة أو فهرس أول عنصر يحقق شرطًا محدَّدًا. | * التابع<nowiki/>[[Ruby/Array/find_index | <code>find_index</code>]]: يجلب فهرس أول ظهور لعنصر محدَّد من مصفوفة أو فهرس أول عنصر يحقق شرطًا محدَّدًا. | ||
* التابع [[Ruby/Array/collect | <code>collect</code>]]: يستدعي كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة ثمَّ يعيد مصفوفة جديدة تحوي القيم التي تعيدها تلك الكتلة. | * التابع<nowiki/>[[Ruby/Array/collect | <code>collect</code>]]: يستدعي كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة ثمَّ يعيد مصفوفة جديدة تحوي القيم التي تعيدها تلك الكتلة. | ||
==مصادر== | ==مصادر== | ||
* [https://ruby-doc.org/core-2.5.1/Array.html#method-i-each_index قسم التابع each_index في الصنف Array في توثيق روبي الرسمي.] | * [https://ruby-doc.org/core-2.5.1/Array.html#method-i-each_index قسم التابع each_index في الصنف Array في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 07:13، 2 أكتوبر 2018
يستدعي التابع each_index كتلة برمجية محددة مع فهرس كل عنصر من عناصر مصفوفة، إذ يُمرَّر ذلك الفهرس كوسيط إلى الكتلة ثم يعيد المصفوفة نفسها.
إن لم تمرَّر أيَّة كتلة إلى التابع each_index، فسيُعيد كائنًا من النوع Enumerator.
البنية العامة
each_index { |index| block } → ary
each_index → Enumerator
القيم المعادة
تعاد المصفوفة نفسها المعطاة بعد تطبيق الكتلة block على فهرس كل عنصر من عناصرها، أو يعاد كائنٌ من النوع Enumerator إن لم تعطَ الكتلة block.
أمثلة
مثالٌ على استخدام التابع each_index:
a = [ "a", "b", "c" ]
a.each_index {|x| print x, " -- " }
سيعطي هذا المثال عند تنفيذه الناتج التالي:
0 -- 1 -- 2 --
انظر أيضًا
- التابع
each: يستدعي كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة، إذ تمرَّر قيمة ذلك العنصر كوسيط إلى الكتلة ثمَّ يعيد المصفوفة نفسها المعطاة. - التابع
find_index: يجلب فهرس أول ظهور لعنصر محدَّد من مصفوفة أو فهرس أول عنصر يحقق شرطًا محدَّدًا. - التابع
collect: يستدعي كتلة برمجية محدَّدة مع كل عنصر من عناصر مصفوفة ثمَّ يعيد مصفوفة جديدة تحوي القيم التي تعيدها تلك الكتلة.