Ruby/String/index

يبحث التابع index عن سلسلة أو نمط مُحدد ضمن السلسلة النصية التي استدعيت معها، ثم يُعيد فهرس أول تطابق يعثر عليه. في حال عدم العثور على أي تطابق، فسيعيد التابع القيمة nil. يمكن تحديد موضع بدء البحث في السلسلة النصية المعطاة عبر تمرير فهرس المحرف الذي يراد بدء البحث عنه.

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

index(substring [, offset]) → integer or nil
index(regexp [, offset]) → integer or nil

المعاملات

substring

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

regexp

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

offset

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

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

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

أمثلة

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

"hello".index('e')             #=> 1
"hello".index('lo')            #=> 3
"hello".index('a')             #=> nil
"hello".index(?e)              #=> 1
"hello".index(/[aeiou]/, -3)   #=> 4

انظر أيضًا

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

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

مصادر

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