الفرق بين المراجعتين لصفحة: «Ruby/Array/index»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>Array.index</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method تصنيف: Ruby Ar...' |
لا ملخص تعديل |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby Array]] | [[تصنيف: Ruby Array]] | ||
يجلب التابع <code>index</code> فهرس أول ظهور لعنصر محدَّد من مصفوفة (يتحقق من التساوي باستعمال المعامل ==) أو فهرس أول عنصر يحقق شرطًا محدَّدًا. | يجلب التابع <code>index</code> فهرس أول ظهور لعنصر محدَّد من مصفوفة (يتحقق من التساوي باستعمال المعامل <code>==</code>) أو فهرس أول عنصر يحقق شرطًا محدَّدًا. | ||
في حال عدم تمرير أي شيء إلى التابع <code>index</code>، سيعيد كائنًا من النوع <code>Enumerator</code>. | |||
في حال عدم تمرير أي شيء إلى التابع <code>index</code>، سيعيد كائنًا من النوع <code>[[Ruby/Enumerator|Enumerator]]</code>. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby"> index(obj) → int or nil | <syntaxhighlight lang="ruby"> index(obj) → int or nil | ||
| سطر 12: | سطر 13: | ||
==المعاملات== | ==المعاملات== | ||
<code>obj</code> | <code>obj</code> | ||
كائن يراد جلب قيمة فهرسه من المصفوفة المعطاة. | كائن يراد جلب قيمة فهرسه من المصفوفة المعطاة. | ||
==القيم المعادة== | ==القيم المعادة== | ||
يعاد عددٌ صحيحٌ يمثِّل فهرس أول ظهور للعنصر <code>obj</code> من المصفوفة المعطاة أو فهرس أول عنصر يحقق الشرط المحدد في الكتلة <code>block</code>، أو تعاد القيمة <code>nil</code> إن لم يعثر على أي عنصر متطابق، أو يعاد كائن من النوع <code>Enumerator</code> إن لم يعطَ الوسيط <code>obj</code> أو الوسيط <code>block</code>. | يعاد عددٌ صحيحٌ يمثِّل فهرس أول ظهور للعنصر <code>obj</code> من المصفوفة المعطاة أو فهرس أول عنصر يحقق الشرط المحدد في الكتلة <code>block</code>، أو تعاد القيمة <code>nil</code> إن لم يعثر على أي عنصر متطابق، أو يعاد كائن من النوع <code>[[Ruby/Enumerator|Enumerator]]</code> إن لم يعطَ الوسيط <code>obj</code> أو الوسيط <code>block</code>. | ||
==أمثلة== | ==أمثلة== | ||
أمثلة على استخدام التابع <code>index</code>: | أمثلة على استخدام التابع <code>index</code>: | ||
| سطر 23: | سطر 25: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* التابع [[Ruby/Array/rindex | <code>rindex</code>]]: يجلب فهرس آخر ظهور لعنصر محدَّد من مصفوفة (يتحقق من التساوي باستعمال المعامل ==) أو فهرس آخر عنصر يحقق شرطًا محدَّدًا. | * التابع [[Ruby/Array/rindex | <code>rindex</code>]]: يجلب فهرس آخر ظهور لعنصر محدَّد من مصفوفة (يتحقق من التساوي باستعمال المعامل <code>==)</code> أو فهرس آخر عنصر يحقق شرطًا محدَّدًا. | ||
* التابع [[Ruby/Array/find_index | <code>find_index</code>]]: يجلب فهرس أول ظهور لعنصر محدَّد من مصفوفة أو فهرس أول عنصر يحقق شرطًا محدَّدًا. | * التابع [[Ruby/Array/find_index | <code>find_index</code>]]: يجلب فهرس أول ظهور لعنصر محدَّد من مصفوفة أو فهرس أول عنصر يحقق شرطًا محدَّدًا. | ||
* التابع [[Ruby/Array/fetch | <code>fetch</code>]]: يجلب عنصرًا ذي فهرس محدَّد من مصفوفة. | * التابع [[Ruby/Array/fetch | <code>fetch</code>]]: يجلب عنصرًا ذي فهرس محدَّد من مصفوفة. | ||
* التابع [[Ruby/Array/each_index | <code>each_index</code>]]: يستدعي كتلة برمجية محددة مع فهرس كل عنصر من عناصر مصفوفة، إذ يُمرَّر ذلك الفهرس كوسيط إلى الكتلة ثم يعيد المصفوفة نفسها. | * التابع [[Ruby/Array/each_index | <code>each_index</code>]]: يستدعي كتلة برمجية محددة مع فهرس كل عنصر من عناصر مصفوفة، إذ يُمرَّر ذلك الفهرس كوسيط إلى الكتلة ثم يعيد المصفوفة نفسها. | ||
==مصادر== | ==مصادر== | ||
* قسم التابع index في الصنف Array في توثيق روبي الرسمي. | * [https://ruby-doc.org/core-2.5.1/Array.html#method-i-index قسم التابع index في الصنف Array في توثيق روبي الرسمي.] | ||
مراجعة 17:37، 6 سبتمبر 2018
يجلب التابع index فهرس أول ظهور لعنصر محدَّد من مصفوفة (يتحقق من التساوي باستعمال المعامل ==) أو فهرس أول عنصر يحقق شرطًا محدَّدًا.
في حال عدم تمرير أي شيء إلى التابع index، سيعيد كائنًا من النوع Enumerator.
البنية العامة
index(obj) → int or nil
index { |item| block } → int or nil
index → Enumerator
المعاملات
obj
كائن يراد جلب قيمة فهرسه من المصفوفة المعطاة.
القيم المعادة
يعاد عددٌ صحيحٌ يمثِّل فهرس أول ظهور للعنصر obj من المصفوفة المعطاة أو فهرس أول عنصر يحقق الشرط المحدد في الكتلة block، أو تعاد القيمة nil إن لم يعثر على أي عنصر متطابق، أو يعاد كائن من النوع Enumerator إن لم يعطَ الوسيط obj أو الوسيط block.
أمثلة
أمثلة على استخدام التابع index:
a = [ "a", "b", "c" ]
a.index("b") #=> 1
a.index("z") #=> nil
a.index { |x| x == "b" } #=> 1
انظر أيضًا
- التابع
rindex: يجلب فهرس آخر ظهور لعنصر محدَّد من مصفوفة (يتحقق من التساوي باستعمال المعامل==)أو فهرس آخر عنصر يحقق شرطًا محدَّدًا. - التابع
find_index: يجلب فهرس أول ظهور لعنصر محدَّد من مصفوفة أو فهرس أول عنصر يحقق شرطًا محدَّدًا. - التابع
fetch: يجلب عنصرًا ذي فهرس محدَّد من مصفوفة. - التابع
each_index: يستدعي كتلة برمجية محددة مع فهرس كل عنصر من عناصر مصفوفة، إذ يُمرَّر ذلك الفهرس كوسيط إلى الكتلة ثم يعيد المصفوفة نفسها.