المعامل [] الخاص بالصنف String في روبي

من موسوعة حسوب
< Ruby‏ | String
اذهب إلى: تصفح، ابحث

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

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

str[integer] = new_str
str[integer, integer] = new_str
str[range] = aString
str[regexp] = new_str
str[regexp, integer] = new_str
str[regexp, name] = new_str
str[other_str] = new_str
يحدَّد الجزء المراد تبديله من السلسلة النصية str بالطريقة نفسها المذكورة في المعامل []. إن كان طول السلسلة النصية المعطاة لا يطابق طول السلسلة النصية (أو الجزء المحدّد) المراد تبديله، فستُعدَّل السلسلة النصية المعطاة تلك وفقًا لذلك. إن كان التعبير النمطي أو السلسلة النصية المستعملة كفهرس لا يطابق موضعًا في السلسلة النصية str المراد تطبيق العملية عليها، فسيُرمَى الخطأ IndexError. إن استُعمَل التعبير النمطي regexp، فالمعامل integer الاختياري الثاني يسمح لك بتحديد أي جزء متطابق تريد استبداله (عبر استعمال قواعد فهرسة الكائن MatchData بفعالية).

سيرمي الشكل الذي يأخذ التعبير النمطي regexp مع المعامل integer الخطأ IndexError إن كانت القيمة المُحدَّدة (الجزء المتطابق) تقع خارج النطاق. سيرمي الشكل الذي يأخذ المجال range الخطا RangeError وسيرمي الشكل الذي يأخذ التعبير النمطي regexp والسلسلة النصية name الخطأ IndexError في حالة التطابق السلبي (negative match).

المعاملات

integer

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

integer

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

range

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

regexp

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

integer

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

name

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

other_str

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

انظر أيضًا

  • المعامل []: يجلب محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه.
  • المعامل ‎=~‎: يطابق التعبير النمطي المُعطى مع سلسلة نصية.
  • المعامل %: يطبِّق السلسلة النصية الواقعة على يساره التي تعد سلسلة تنسيق معيارية على الكائن المعطى الواقع على يمينه ثم يعيد الناتج.

مصادر