الفرق بين المراجعتين لصفحة: «Ruby/Array/find index»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: التابع <code>Array.find_index</code> في روبي}}</noinclude> | |||
[[تصنيف: Ruby]] | |||
[[تصنيف: Ruby Method]] | |||
[[تصنيف: Ruby Array]] | |||
يجلب التابع <code>find_index</code> فهرس أول ظهور لعنصر محدَّد من مصفوفة أو فهرس أول عنصر يحقق شرطًا محدَّدًا. | يجلب التابع <code>find_index</code> فهرس أول ظهور لعنصر محدَّد من مصفوفة أو فهرس أول عنصر يحقق شرطًا محدَّدًا. | ||
في حال عدم تمرير أي وسيط أو كتلة برمجية إلى التابع <code>find_index</code>، فسيعيد كائنًا من النوع <code>[[Ruby | في حال عدم تمرير أي وسيط أو كتلة برمجية إلى التابع <code>find_index</code>، فسيعيد كائنًا من النوع <code>[[Ruby/Enumerator|Enumerator]]</code>. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby"> find_index(obj) → int or nil | <syntaxhighlight lang="ruby"> find_index(obj) → int or nil | ||
| سطر 12: | سطر 16: | ||
الكائن المراد جلب فهرسه من المصفوفة المعطاة. | الكائن المراد جلب فهرسه من المصفوفة المعطاة. | ||
==القيم المعادة== | ==القيم المعادة== | ||
يعاد عددٌ صحيح يمثِّل فهرس أول ظهور للعنصر <code>obj</code> من المصفوفة المعطاة أو فهرس أول عنصر يحقق الشرط المحدد في الكتلة <code>block</code>، أو تعاد القيمة <code>nil</code> إن لم يعثر على أي عنصر متطابق، أو يعاد كائن من النوع <code>[[Ruby/Array/Enumerator|Enumerator]]</code> إن لم يعطَ الوسيط <code>obj</code> أو الوسيط <code>block</code>. | يعاد عددٌ صحيح يمثِّل فهرس أول ظهور للعنصر <code>obj</code> من المصفوفة المعطاة أو فهرس أول عنصر يحقق الشرط المحدد في الكتلة <code>block</code>، أو تعاد القيمة <code>nil</code> إن لم يعثر على أي عنصر متطابق، أو يعاد كائن من النوع [[Ruby/Enumerator|<code></code>]]<code>[[Ruby/Array/Enumerator|Enumerator]]</code> إن لم يعطَ الوسيط <code>obj</code> أو الوسيط <code>block</code>. | ||
==أمثلة== | ==أمثلة== | ||
أمثلة على استخدام التابع <code>find_index</code>:<syntaxhighlight lang="ruby"> a = [ "a", "b", "c" ] | أمثلة على استخدام التابع <code>find_index</code>:<syntaxhighlight lang="ruby"> a = [ "a", "b", "c" ] | ||
| سطر 20: | سطر 24: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
*[[Ruby/Array/index| <code>index</code>]]: يجلب فهرس أول ظهور لعنصر محدَّد من مصفوفة (يتحقق من التساوي باستعمال المعامل ==) أو فهرس أول عنصر يحقق شرطًا محدَّدًا. | *التابع<nowiki/>[[Ruby/Array/index| <code>index</code>]]: يجلب فهرس أول ظهور لعنصر محدَّد من مصفوفة (يتحقق من التساوي باستعمال المعامل <code>[[Ruby/Array/equal|==]]</code>) أو فهرس أول عنصر يحقق شرطًا محدَّدًا. | ||
*التابع | *التابع<nowiki/>[[Ruby/Array/at| <code>at</code>]]: يجلب عنصرًا ذي فهرس محدد من المصفوفة المستدعاة معه. | ||
*التابع [[Ruby/Array/each index| <code>each_index</code>]]: يستدعي كتلة برمجية محددة مع فهرس كل عنصر من عناصر مصفوفة، إذ يُمرَّر ذلك الفهرس كوسيط إلى الكتلة ثم يعيد المصفوفة نفسها. | *التابع<nowiki/>[[Ruby/Array/each index| <code>each_index</code>]]: يستدعي كتلة برمجية محددة مع فهرس كل عنصر من عناصر مصفوفة، إذ يُمرَّر ذلك الفهرس كوسيط إلى الكتلة ثم يعيد المصفوفة نفسها. | ||
==مصادر== | ==مصادر== | ||
*[https://ruby-doc.org/core-2.5.1/Array.html#method-i-find_index قسم التابع find_index في الصنف Array في توثيق روبي الرسمي.] | *[https://ruby-doc.org/core-2.5.1/Array.html#method-i-find_index قسم التابع find_index في الصنف Array في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 07:19، 2 أكتوبر 2018
يجلب التابع find_index فهرس أول ظهور لعنصر محدَّد من مصفوفة أو فهرس أول عنصر يحقق شرطًا محدَّدًا.
في حال عدم تمرير أي وسيط أو كتلة برمجية إلى التابع find_index، فسيعيد كائنًا من النوع Enumerator.
البنية العامة
find_index(obj) → int or nil
find_index { |item| block } → int or nil
find_index → Enumerator
المعاملات
obj
الكائن المراد جلب فهرسه من المصفوفة المعطاة.
القيم المعادة
يعاد عددٌ صحيح يمثِّل فهرس أول ظهور للعنصر obj من المصفوفة المعطاة أو فهرس أول عنصر يحقق الشرط المحدد في الكتلة block، أو تعاد القيمة nil إن لم يعثر على أي عنصر متطابق، أو يعاد كائن من النوع Enumerator إن لم يعطَ الوسيط obj أو الوسيط block.
أمثلة
أمثلة على استخدام التابع find_index:
a = [ "a", "b", "c" ]
a.find_index("b") #=> 1
a.find_index("z") #=> nil
a.find_index { |x| x == "b" } #=> 1
انظر أيضًا
- التابع
index: يجلب فهرس أول ظهور لعنصر محدَّد من مصفوفة (يتحقق من التساوي باستعمال المعامل==) أو فهرس أول عنصر يحقق شرطًا محدَّدًا. - التابع
at: يجلب عنصرًا ذي فهرس محدد من المصفوفة المستدعاة معه. - التابع
each_index: يستدعي كتلة برمجية محددة مع فهرس كل عنصر من عناصر مصفوفة، إذ يُمرَّر ذلك الفهرس كوسيط إلى الكتلة ثم يعيد المصفوفة نفسها.