Ruby/String/rindex

يبحث التابع rindex عن سلسلة أو نمط مُحدد ضمن السلسلة النصية التي استدعي معها، ثم يُعيد فهرس آخر تطابق يعثر عليه. في حال عدم العثور على أي تطابق، فإن التابع يُعيد القيمة nil. يمكن تحديد موضع نهاية البحث في السلسلة النصية باستعمال المعامل الثاني (المعامل offset).

البنية العامة

rindex(substring [, integer]) → integer or nil
rindex(regexp [, integer]) → integer or nil

المعاملات

substring

السلسلة المُراد البحث عنها ضمن السلسلة النصية المُعطاة.

regexp

التعبير النمطي المُراد مطابقته والبحث عنه ضمن السلسلة النصية المُعطاة.

offset

عدد صحيح يُحدد موضع نهاية البحث في السلسلة النصية المُعطاة.

القيمة المعادة

يُعاد عدد صحيح يمثِّل فهرس آخر تطابق يعثر عليه التابع، أو تُعاد القيمة nil في حال عدم العثور على أي تطابق.

أمثلة

مثال على استعمال التابع rindex:

"hello".rindex('e')             #=> 1
"hello".rindex('l')             #=> 3
"hello".rindex('a')             #=> nil
"hello".rindex(?e)              #=> 1
"hello".rindex(/[aeiou]/, -2)   #=> 1

انظر أيضًا

• المعامل []: يجلب محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه.

• التابع index: يبحث عن سلسلة أو نمط مُحدد ضمن السلسلة النصية التي استدعيت معها، ثم يُعيد فهرس أول تطابق يعثر عليه.
• التابع replace: يستبدل محتوى السلسلة النصية التي استدعي معها بمحتوى السلسلة المُمرَّرة إليه.

مصادر

• قسم التابع rindex‎ في الصنف String في توثيق روبي الرسمي.