عرض مصدر Ruby/String/rindex

<noinclude>{{DISPLAYTITLE:التابع <code>String.rindex</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby String]]
يبحث التابع <code>rindex</code> عن سلسلة أو نمط مُحدد ضمن السلسلة النصية التي استدعي معها، ثم يُعيد فهرس آخر تطابق يعثر عليه. في حال عدم العثور على أي تطابق، فإن التابع يُعيد القيمة <code>nil</code>. يمكن تحديد موضع نهاية البحث في السلسلة النصية باستعمال المعامل الثاني (المعامل <code>offset</code>).
==البنية العامة==
<syntaxhighlight lang="ruby">rindex(substring [, integer]) → integer or nil
rindex(regexp [, integer]) → integer or nil</syntaxhighlight>

== المعاملات ==

=== <code>substring</code> ===
السلسلة المُراد البحث عنها ضمن السلسلة النصية المُعطاة.

=== <code>regexp</code> ===
[[Ruby/Regexp|التعبير النمطي]] المُراد مطابقته والبحث عنه ضمن السلسلة النصية المُعطاة.

=== <code>offset</code> ===
عدد صحيح يُحدد موضع نهاية البحث في السلسلة النصية المُعطاة.

==القيمة المعادة==
يُعاد [[Ruby/Integer|عدد صحيح]] يمثِّل فهرس آخر تطابق يعثر عليه التابع، أو تُعاد القيمة <code>nil</code> في حال عدم العثور على أي تطابق. 

==أمثلة==
مثال على استعمال التابع <code>rindex</code>:
<syntaxhighlight lang="ruby">"hello".rindex('e')             #=> 1
"hello".rindex('l')             #=> 3
"hello".rindex('a')             #=> nil
"hello".rindex(?e)              #=> 1
"hello".rindex(/[aeiou]/, -2)   #=> 1</syntaxhighlight>

==انظر أيضًا==
* المعامل <code>[[Ruby/String/5B-5D|[]]]</code>: يجلب محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه.

* التابع <code>[[Ruby/String/index|index]]</code>: يبحث عن سلسلة أو نمط مُحدد ضمن السلسلة النصية التي استدعيت معها، ثم يُعيد فهرس أول تطابق يعثر عليه.
* التابع <code>[[Ruby/String/replace|replace]]</code>: يستبدل محتوى السلسلة النصية التي استدعي معها بمحتوى السلسلة المُمرَّرة إليه.

==مصادر==
*[http://ruby-doc.org/core-2.5.1/String.html#method-i-rindex قسم التابع rindex‎ في الصنف String في توثيق روبي الرسمي.]