Ruby/String/5B-5D

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

في الحالات الثلاث السابقة، إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع المحرف بدءًا من نهاية السلسلة، إذ تمثل القيمة ‎-1 فهرس المحرف الأخير.

بالنسبة للحالتين الثانية والثالثة، فهرس البداية يُحسب قبل محرف واحد والفهرس يطابق حجم السلسلة.

عند تمرير تعبير نمطي (Regexp) إلى المعامل []، يعيد الجزء المطابق من السلسلة. إذا أُلحق التعبير النمطي بمُعامل التقاط (capture)، وهو عبارة عن اسم أو فهرس لمجموعة التقاط ضمن التعبير النمطي، فإن المعامل [] يعيد المجموعة المُحددة بدلًا من إرجاع الجزء المُطابق (MatchData) بأكمله.

عند تمرير سلسلة إلى المعامل، ستُعاد هذه السلسلة في حال كانت محتواة في السلسلة النصية؛ أما في حال لم تكن، ستُعاد القيمة nil.

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

str[index] → new_str or nil
str[start, length] → new_str or nil
str[range] → new_str or nil
str[regexp] → new_str or nil
str[regexp, capture] → new_str or nil
str[match_str] → new_str or nil

المعاملات

index

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

start

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

length

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

range

مجال يحدد فهرس البداية وفهرس النهاية لسلسلة المحارف المراد جلبها من السلسلة المُستدعاة.

regexp

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

capture

فهرس أو اسم للمجموعة الملتقطة في التعبير النظامي regexp المُراد إعادتها فقط.

match_str

السلسلة المراد جلبها من السلسلة المُستدعاة.

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

تُعاد سلسلة من محرف وحيد ضمن الفهرس index المُحدد، أو سلسلة محارف محددة بالبداية start والطول length أو بالمجال range.

إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع المحرف بدءًا من نهاية السلسلة، إذ تمثل القيمة ‎-1 فهرس المحرف الأخير.

تُعاد سلسلة فارغة في حال كان فهرس بداية المجال المُحدد يقع عند نهاية السلسلة.

تُعاد القيمة nil في حال كان الفهرس خارج السلسلة أو في حال تمرير طول سالب.

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

تُعاد سلسلة محددة مُحتواة في السلسلة النصية المعطاة، أو تعاد القيمة nil في حال لم تكن السلسلة المُحددة موجودة في السلسلة النصية.

أمثلة

مثال على استخدام المعامل []:

a = "hello there"

a[1]                   #=> "e"
a[2, 3]                #=> "llo"
a[2..3]                #=> "ll"

a[-3, 2]               #=> "er"
a[7..-2]               #=> "her"
a[-4..-2]              #=> "her"
a[-2..-4]              #=> ""

a[11, 0]               #=> ""
a[11]                  #=> nil
a[12, 0]               #=> nil
a[12..-1]              #=> nil

a[/[aeiou](.)\1/]      #=> "ell"
a[/[aeiou](.)\1/, 0]   #=> "ell"
a[/[aeiou](.)\1/, 1]   #=> "l"
a[/[aeiou](.)\1/, 2]   #=> nil

a[/(?<vowel>[aeiou])(?<non_vowel>[^aeiou])/, "non_vowel"] #=> "l"
a[/(?<vowel>[aeiou])(?<non_vowel>[^aeiou])/, "vowel"]     #=> "e"

a["lo"]                #=> "lo"
a["bye"]               #=> nil

انظر أيضًا

• المعامل ‎[]=‎‎: يبدِّل سلسلةً نصيةً محدَّدةً مكان جزءٍ محدَّد أو كامل محتوى سلسلة نصية أخرى.  

• المعامل <=>: يُقارن بين سلسلتين نصيتين ثم يعيد القيم 1-، أو 1، أو 0، إذا ما كانت السلسلة النصية الأولى أكبر أو أصغر أو تساوي السلسلة النصية الثانية على التوالي.
• المعامل ==: يتحقق من تساوي السلسلة النصية مع أي كائن آخر، علمًا أن المساواة تتحقق عند تطابق الطول والمحتوى.

مصادر

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