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