التابع 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: يجلب محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه.